As described in https://github.com/0xPolygonMiden/miden-base/issues/472, we want documentation for the Miden Node. The source files of the documentation should be located in the Node repo. Then, developers can update the docs in the same PR as the code.
Target group for the Miden Node docs
We have different target groups for our documentation:
People who want to use Polygon Miden. For now, this is mostly people who may want to play with it - but in the future, it can be people who want to participate in running the network.
People who want to develop on top of Polygon Miden - e.g., write new smart contracts (accounts, notes), build new applications, etc.
People who want to contribute to Polygon Miden - e.g., those who may be interested in making proposals to improve the protocol or contribute to note/client development etc.
For now, the order of importance is the above. That means the docs should be super clear about how to interact with the Miden Node.
Proposed structure
How to interact w/ the Node Interface (probably the API / RPC endpoints and a description thereof)
How the Node works Design (the components of the Node and why we chose the design as is)
There should be a subchapter about Batch and Block Kernel and how nullifier are being checked
How to run a Node: There is no need to put a lot of effort here, since atm we don't expect ppl to run a node
Mkdocs
We are going to use Mkdocs and a plugin to build the Miden unified docs in docs.polygon.technology .
So please build the docs having mkdocs material already in mind.
We need docs for the Miden Node
As described in https://github.com/0xPolygonMiden/miden-base/issues/472, we want documentation for the Miden Node. The source files of the documentation should be located in the Node repo. Then, developers can update the docs in the same PR as the code.
Target group for the Miden Node docs
We have different target groups for our documentation:
For now, the order of importance is the above. That means the docs should be super clear about how to interact with the Miden Node.
Proposed structure
Mkdocs
We are going to use Mkdocs and a plugin to build the Miden unified docs in docs.polygon.technology .
So please build the docs having mkdocs material already in mind.