With the heavy focus in being state of the art, Nano has and continues to undertake major changes both to its protocol and node implementation designs. At this point, the original whitepaper is outdated in several aspects.
After open-sourcing the whitepaper, we are now working on a revamp, towards a "living whitepaper" that will live in our documentation website. Feedback on this website has been overwhelmingly positive, and we believe it will be a perfect place to store an ever-evolving version of the whitepaper; hence, living.
With this living whitepaper, we also want to detail both the protocol design and node implementation. The latter is not detailed in the original whitepaper, and it provides a path to understanding design decisions for those who are not developers but still want to deepen their knowledge of Nano. Hopefully, this will also lead to more third party contributions to the codebase.
In line with our open-source approach to almost all Nano Foundation projects, people willing to contribute their knowledge of Nano (protocol and node implementation), will be able to do so via pull-requests to the whitepaper branch on the nano-docs repository.
This thread can be used to coordinate writing efforts, discussions, and avoiding redundancy.
How to contribute - a quick git tutorial for beginners
- See nano-docs#contributing
- Fork nano-docs and set it up locally. Clone from your fork, then add the main repository as upstream to pull updates as they're added:
git remote add upstream https://github.com/nanocurrency/nano-docs.git
- Always checkout and pull updates in the whitepaper branch
git checkout whitepaper && git pull upstream whitepaper
- The navigation panel should have the Protocol Design and (new) Node Implementation sections
git checkout -b new-branch-name(your choice of name, relevant to what you will write about)
- Pick a topic, and start writing, or make improvements to an existing one
git push origin new-branch-nameare the minimum set of commands you will need to push the changes to your fork
- Visit the nano-docs repository website and you should see a popup to make a PR. The PR should merge into the whitepaper branch, not master branch.
- Wait for our feedback!
git is discouraging you from contributing, but you would really like to write something, please let me know.