github.com/badrootd/nibiru-cometbft@v0.37.5-0.20240307173500-2a75559eee9b/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