README: add a link to the official spec

[functorrent.git] / README.md

diff --git a/README.md b/README.md
index 691450858c142f8ea14e243dc410a49baf169aee..4885b0ee28aa380009cb1f89762a675532ea8b61 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,25 +2,27 @@
 
 [![Build Status](https://travis-ci.org/vu3rdd/functorrent.svg?branch=master)](https://travis-ci.org/vu3rdd/functorrent)
 
-## building
+## Building
 
-I suggest using cabal sandbox.
+Functorrent can be build with [Cabal](https://www.haskell.org/cabal/) sandbox or
+[Nix](https://nixos.org/nix/).
 
-Or you can use [Nix](https://nixos.org/nix/), in which case, typing ```nix-shell```
-at the root of the source code repo should drop you into a shell which has all the package
-dependencies installed.
+### Cabal sandbox
 
-### Steps:
+Sandboxes give you per project independent containers, just like Python's
+virtualenv.
 
-## for cabal sandbox
-clone the repo; cd functorrent;
 
+    $ git clone https://github.com/vu3rdd/functorrent && cd functorrent
     $ cabal sandbox init
-    $ wget http://www.stackage.org/lts/cabal.config
     $ cabal install --only-dependencies --enable-tests
     $ cabal build # binaries in ./dist/built/functorrent/*
 
-## for nix
+### Building with Nix
+
+``$ nix-shell``` at the root of the source code repo should drop you into a
+shell which has all the package dependencies installed.
+
 
     $ nix-shell --pure
     [...]
@@ -31,7 +33,7 @@ clone the repo; cd functorrent;
 - Become more profient with Haskell.
 - Implement something non-trivial with Haskell (crypto, file operations, network
   operations, concurrency, bit twiddling, DHT).
-- Follow the spec - https://wiki.theory.org/BitTorrentSpecification
+- Follow the spec ([official spec](http://bittorrent.org/beps/bep_0003.html), [unofficial spec](https://wiki.theory.org/BitTorrentSpecification))
 - Easy for newbies like me to read and understand along side the spec.
 - doctest and quickcheck tests.
 - Follow Haskell Style Guide - https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md