github.com/pokt-network/tendermint@v0.32.11-0.20230426215212-59310158d3e9/docs/architecture/adr-035-documentation.md (about) 1 # ADR 035: Documentation 2 3 Author: @zramsay (Zach Ramsay) 4 5 ## Changelog 6 7 ### November 2nd 2018 8 9 - initial write-up 10 11 ## Context 12 13 The Tendermint documentation has undergone several changes until settling on the current model. Originally, the documentation was hosted on the website and had to be updated asynchronously from the code. Along with the other repositories requiring documentation, the whole stack moved to using Read The Docs to automatically generate, publish, and host the documentation. This, however, was insufficient; the RTD site had advertisement, it wasn't easily accessible to devs, didn't collect metrics, was another set of external links, etc. 14 15 ## Decision 16 17 For two reasons, the decision was made to use VuePress: 18 19 1) ability to get metrics (implemented on both Tendermint and SDK) 20 2) host the documentation on the website as a `/docs` endpoint. 21 22 This is done while maintaining synchrony between the docs and code, i.e., the website is built whenever the docs are updated. 23 24 ## Status 25 26 The two points above have been implemented; the `config.js` has a Google Analytics identifier and the documentation workflow has been up and running largely without problems for several months. Details about the documentation build & workflow can be found [here](../DOCS_README.md) 27 28 ## Consequences 29 30 Because of the organizational seperation between Tendermint & Cosmos, there is a challenge of "what goes where" for certain aspects of documentation. 31 32 ### Positive 33 34 This architecture is largely positive relative to prior docs arrangements. 35 36 ### Negative 37 38 A significant portion of the docs automation / build process is in private repos with limited access/visibility to devs. However, these tasks are handled by the SRE team. 39 40 ### Neutral