From e0a260b0de55fbea0c507eb0ca5fbdc3c1a825c0 Mon Sep 17 00:00:00 2001
From: Arun Isaac
Date: Tue, 4 Jan 2022 12:08:27 +0530
Subject: README: Document `guix shell' development process.

* README.md: Clean up and document `guix shell' development process.
---
 README.md | 32 +++++++++++++++++---------------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/README.md b/README.md
index 2b41a415..ea473699 100644
--- a/README.md
+++ b/README.md
@@ -11,24 +11,27 @@ many different populations and many types of molecular, cellular, and physiologi
 The system is used by scientists and clinicians in the field of precision health care and systems genetics.
 GN and its predecessors have been in operation since Jan 1994, making it one of the longest-lived web services in biomedical research (https://en.wikipedia.org/wiki/GeneNetwork, and see a partial list of publications using GN and its predecessor, WebQTL (https://genenetwork.org/references/).
 
-## Install
-
-The recommended installation is with GNU Guix which allows you to
-deploy GN2 and dependencies as a self contained unit on any machine.
-The database can be run separately as well as the source tree (for
-developers).  See the [installation docs](doc/README.org).
-
 ## Run
 
-Once having installed GN2 it can be run through a browser
-interface
+We recommend you use GNU Guix. GNU Guix allows you to deploy
+GeneNetwork2 and dependencies as a self contained unit on any machine.
+The database can be run separately as well as the source tree (for
+developers).
 
+Make sure you have the
+[guix-bioinformatics](https://git.genenetwork.org/guix-bioinformatics/guix-bioinformatics)
+channel set up. Then, to drop into a development environment with all
+dependencies, run
 ```sh
-genenetwork2
+guix shell -Df guix.scm
+```
+Or, to drop into a development environment in a container, run
+```
+guix shell -C --network -Df guix.scm
 ```
 
-A quick example is
-
+In the development environment, start GeneNetwork2 by running, for
+example,
 ```sh
 env SERVER_PORT=5300 \
     GENENETWORK_FILES=~/data/gn2_data/ \
@@ -39,13 +42,12 @@ env SERVER_PORT=5300 \
 
 For full examples (you may need to set a number of environment
 variables), including running scripts and a Python REPL, also see the
-startup script [./bin/genenetwork2](https://github.com/genenetwork/genenetwork2/blob/testing/bin/genenetwork2).
+startup script
+[./bin/genenetwork2](https://github.com/genenetwork/genenetwork2/blob/testing/bin/genenetwork2).
 
 Also mariadb and redis need to be running, see
 [INSTALL](./doc/README.org).
 
-## Development
-
 ## Testing
 
 To have tests pass, the redis and mariadb instance should be running, because of
-- 
cgit v1.2.3