If you are contributing to the repository, make sure to fork this repo, and then clone your own fork. You will need to do this to make creating pull requests easier.
git clone https://github.com/<your-username>/terra-docs
All articles are markdown files, placed under the /docs/
directory. You can create folders underneath the /docs
directory, such as the following:
/docs
/dev
README.md
spec-auth.md
...
/node
README.md
installation.md
...
README.md
Notice how README.md
serves as the default root of the folder.
To edit the navigation to include your new article, edit /docs/.vuepress/config.js
and add your new article in the appropriate section in themeConfig.sidebar
, following the other paths as examples.
Make sure you install all the dependencies:
npm install
Build and run locally (hot-reloading dev server):
npm run dev
Each module should be documented with the following subheaders:
-
Abstract (no header)
Maximum 2 paragraphs to explain, in broad terms, the general purpose of the module, to provide a "big-picture" perspective of how the module provides functionality and organization to the Terra protocol, and how it interacts with other modules.
-
Concepts
A section dedicated to the concepts that are required to understand how the module works. This may include:
- layman primer
- math formulas (formatted with LaTeX)
- diagrams
-
Data
A section that covers the various data structures used by the module.
-
State
A section that covers the keeper state for that module key-value store
-
Messages
A section that covers the various types of messages and gives a rough explanation on how they are handled.
-
Proposals
A section that covers the related governance proposals
-
Transitions
A section that covers the begin-blocker and end-blocker transition functions
-
Parameters
A section that covers the chain parameters that can be modified by governance via the
params
module
- Vuepress
- MathJax
- Terra Docs custom theme
This software is licensed under the MIT license. See LICENSE for full disclosure.
© 2020 Terraform Labs, PTE.