73fc1d5a2b
* refactor index.md * move philosophy.md into index.md * clean up the 'getting started' topic move how-to's to the how-to section * cleaner titles * move prerequisites to the install.md page * hardware.md: small refactor * improve quick-start.md * refactor eth1.md * refactor validating guide * reverse the order of BN and LC in the table * pi-guide.md: minor edit * Apply suggestions from code review Co-authored-by: tersec <tersec@users.noreply.github.com> * make link texts more concrete * remove comparison to other clients * add some more explanations to `build.md` * change 'days' to 'hours' --------- Co-authored-by: tersec <tersec@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| nbc_audit_2020 | ||
| the_auditors_handbook | ||
| the_nimbus_book | ||
| .gitignore | ||
| Makefile | ||
| README.md | ||
| attestation_flow.dot | ||
| attestation_flow.md | ||
| attestation_flow.png | ||
| block_flow.dot | ||
| block_flow.md | ||
| block_flow.png | ||
| cpu_features.md | ||
| e2store.md | ||
| eth2-finalization.png | ||
| logging.md | ||
| requirements.in | ||
| requirements.txt | ||
README.md
Documentation
material for mkdocs
The Nimbus guide is generated using Material for mkdocs, and installed using a python VENV (see Makefile).
mdbook
Some books in this folder were produced using mdBook - see installation guide.
# Install or update tooling (make sure you add "~/.cargo/bin" to PATH):
cargo install mdbook --version 0.4.18
cargo install mdbook-toc --version 0.8.0
cargo install mdbook-open-on-gh --version 2.1.0
cargo install mdbook-admonish --version 1.7.0
# Work on the book locally - open "http://localhost:4000" for live version
cd docs/the_nimbus_book
mdbook serve -p 4000
# Create a local copy of the book
make book
# Publish book using makefile (in the top-level dir)
make publish-book