diff --git a/README.md b/README.md index c26dae219..8552d64ee 100644 --- a/README.md +++ b/README.md @@ -33,12 +33,12 @@ If you'd like some background on Sigma Prime, please see the [Lighthouse Update - [`beacon_node/`](beacon_node/): the "Beacon Node" binary and crates exclusively associated with it. -- [`docs/`](docs/): documentation related to the repository. This include contributor - guides, etc. (Code documentation is produced with `cargo doc`). +- [`docs/`](docs/): documentation related to the repository. This includes contributor + guides, etc. (It does not include code documentation, which can be produced with `cargo doc`). - [`eth2/`](eth2/): Crates containing common logic across the Lighthouse project. For - example; Ethereum 2.0 types ([`BeaconBlock`](eth2/types/src/beacon_block.rs), [`BeaconState`](eth2/types/src/beacon_state.rs), etc) and + example: Ethereum 2.0 types ([`BeaconBlock`](eth2/types/src/beacon_block.rs), [`BeaconState`](eth2/types/src/beacon_state.rs), etc) and SimpleSerialize (SSZ). -- [`protos/`](protos/): protobuf/gRPC definitions common across the Lighthouse project. +- [`protos/`](protos/): protobuf/gRPC definitions that are common across the Lighthouse project. - [`validator_client/`](validator_client/): the "Validator Client" binary and crates exclusively associated with it. diff --git a/eth2/README.md b/eth2/README.md index e7b69635a..cf041e987 100644 --- a/eth2/README.md +++ b/eth2/README.md @@ -8,19 +8,19 @@ Rust crates containing logic common across the Lighthouse project. - [`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 +- [`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 around an external BLS encryption library. - - [`boolean-bitfield`](utils/boolean-bitfield/): Provides an expandable Vec + - [`bls`](utils/bls/): A wrapper for an external BLS encryption library. + - [`boolean-bitfield`](utils/boolean-bitfield/): Provides an expandable vector of bools, specifically for use in Eth2. - [`fisher-yates-shuffle`](utils/fisher-yates-shuffle/): shuffles a list pseudo-randomly. - - [`hashing`](utils/hashing/): A wrapper around external hashing libraries. + - [`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 + 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. @@ -30,8 +30,8 @@ Rust crates containing logic common across the Lighthouse project. - [`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 `Encodable`, `Decodable` and `TreeHash` methods. + deriving SSZ `Encodable`, `Decodable`, and `TreeHash` methods. - [`swap_or_not_shuffle`](utils/swap_or_not_shuffle/): a list-shuffling - method which is slow, but allows for shuffling a subset of indices. + 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`.