Augment `README'.

1 files changed, 37 insertions, 0 deletions

diff --git a/README b/README
index b77c0fa4c9..442e4c3f35 100644
--- a/README
+++ b/README
@@ -1,3 +1,5 @@
+-*- mode: org -*-
+
 Guix is Nix[0] from Guile[1]!
 
 Concretely, it allows Nix package management to be done entirely in
@@ -7,3 +9,38 @@ Nix language.
 
 [0] http://nixos.org/nix/
 [1] http://gnu.org/software/guile/
+
+
+* Hacking
+
+Guix currently depends on the following packages:
+
+  - GNU Guile 2.0.x, http://gnu.org/software/guile/
+  - Nix, http://nixos.org/nix/
+  - libchop, http://nongnu.org/libchop/
+
+For bootstrapping purposes, it is useful to reuse packages from Nixpkgs.
+For this to work, you need to have a checkout of the Nixpkgs repository,
+with the `NIXPKGS' environment variable pointing to it.
+
+  - Nixpkgs, http://nixos.org/nixpkgs/
+
+* How It Works
+
+Guix does the high-level preparation of a /derivation/.  A derivation is
+the promise of a build; it is stored as a text file under
+=/nix/store/xxx.drv=.  The (guix derivations) module provides the
+`derivation' primitive, as well as higher-level wrappers such as
+`build-expression->derivation'.
+
+Guix does remote procedure calls (RPCs) to the Nix daemon (the
+=nix-worker --daemon= command), which in turn performs builds and
+accesses to the Nix store on its behalf.  The RPCs are implemented in
+the (guix store) module.
+
+* Contact
+
+The repository is at <https://gitorious.org/guix/>.
+
+Please email <ludo@gnu.org> or <nix-dev@lists.science.uu.nl>, or
+join #guile or #nixos on irc.freenode.net or `civodul'.