Refactor docs into mdbook (#547)

* Refactor documentation, ef_tests makefile

* Add makefile to root

* Tidy readme

* Fix readme badges

* Tidy logs

* Add terminalize gif

* Update readme image

* Update readme image

* Tidy logs

* Update readme image

* Update readme

* Update readme

* Fix book link

* Update makefiles

* Update book

* Fix link in book

* Add readme for book

* Remove old docs, move api spec YAML

* Fix eth2/ dir readme

* Add readme for lcli

* Add about this book section

* Minor formatting improvements

* Address mehdi's comments

eth2/README.md

@@ -1,35 +1,3 @@
-# Ethereum 2.0 Common Crates
+# eth2
 
-Rust crates containing logic common across the Lighthouse project.
-
-## Per-Crate Summary
-
-- [`attester/`](attester/): Core logic for attesting to beacon and shard blocks.
-- [`block_proposer/`](block_proposer/): Core logic for proposing beacon blocks.
-- [`fork_choice/`](fork_choice/): A collection of fork-choice algorithms for
-	the Beacon Chain.
-- [`state_processing/`](state_processing/): Provides per-slot, per-block, and
-	per-epoch state processing.
-- [`types/`](types/): Defines base Ethereum 2.0 types (e.g., `BeaconBlock`,
-	`BeaconState`, etc).
-- [`utils/`](utils/):
-    - [`bls`](utils/bls/): A wrapper for an external BLS encryption library.
-    - [`fisher-yates-shuffle`](utils/fisher-yates-shuffle/): shuffles a list
-		pseudo-randomly.
-    - [`hashing`](utils/hashing/): A wrapper for external hashing libraries.
-    - [`honey-badger-split`](utils/honey-badger-split/): Splits a list in `n`
-		parts without giving AF about the length of the list, `n`, or anything
-		else.
-    - [`int-to-bytes`](utils/int-to-bytes/): Simple library which converts ints
-		into byte-strings of various lengths.
-	- [`slot_clock`](utils/slot_clock/): translates the system time into Beacon
-	    Chain "slots". (Also provides another slot clock that's useful during
-		testing.)
-	- [`ssz`](utils/ssz/): an implementation of the SimpleSerialize 
-	    serialization/deserialization protocol used by Eth 2.0.
-	- [`ssz_derive`](utils/ssz_derive/): provides procedural macros for
-		deriving SSZ `Encode`, `Decode`, and `TreeHash` methods.
-	- [`swap_or_not_shuffle`](utils/swap_or_not_shuffle/): a list-shuffling
-		method which is slow, but allows for a subset of indices to be shuffled.
-	- [`test_random_derive`](utils/test_random_derive/): provides procedural
-		macros for deriving the `TestRandom` trait defined in `types`.
+Common crates containing eth2-specific logic.