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> |
||
---|---|---|
.. | ||
src | ||
.gitignore | ||
CNAME | ||
README.md | ||
mkdocs.yml |
README.md
The Nimbus Guide is written using markdown and material for mkdocs.
See the Makefile
for setup.
The guide is divided into several sections - broadly:
- Guides - walk-throughs that allow the user to get started with a specific area of the client
- How-to:s - short pages that show the user how to solve a specific problem or perform a specific task
- Reference - pages describing how specific parts of Nimbus work, reference-style
- "Other" - explanations of concepts, background etc.
Resources
- material for mkdocs - doc generator
- divio - useful resource diving into the above section structure