Initial commit.

Sketching Scheme/C interop.

1 files changed, 20 insertions, 0 deletions

diff --git a/README.org b/README.org
new file mode 100644
index 0000000..8ddf847
--- /dev/null
+++ b/README.org
@@ -0,0 +1,20 @@
+* Introduction
+
+`schewn' (pronounced skew with an extra `n' sound at the end) is a
+floating and manual tiling window manager written in C for performance
+and (Guile) Scheme for extensibility (and configuration).
+
+As expected from most window managers, every action is configurable to
+be bound to a set of keys or mouse actions. The internals of `schewn'
+are kept to its C core, but its capabilities are exposed as a Scheme
+API.
+
+This project aims to provide something more akin to `2bwm' but with
+Scheme extensibility, with the aim of being a more ergonomic, dynamic,
+and convenient way of configuring the window manager to do what the
+user wants without wondering about recompiling its source code.
+
+Compared to StumpWM, we do not aim to have a Lisp-based window
+manager, but rather a convenient library of Scheme functions which
+only expose the functionality of the window manager, while having a
+core in C which does the heavy lifting.