This the main repository for the Mantra Public API documentation.
Anyone is welcome to contribute to the public Mantra API documentation by making a pull request into the master repository.
The documentation is split into the following sections:
- Articles
- This section may in time host a series of usefull article to help developers on topics such as:
- how to best use the public APIs
- how to troubleshoot common issues
- This section may in time host a series of usefull article to help developers on topics such as:
- API Concepts
- This section hosts the main guidelines on using the Public API along with the API References
The documentation is built using a static documentation generator called DocFX. The documentation content is saved in Markdown files and then built into a website using DocFX. The table of content is saved into separate toc.yml files.
In order for you to make a contribution directly please follow the next steps:
-
Create a local branch from the main repository
-
Add your changes by modifying existing Markdown files or by adding new Markdown files
-
Create a Pull Request with your changes.
- This pull request will be reviewed for correctness by one of our technical writers
-
Once your pull request has been approved and committed into the main branch, an automatic pipeline will be triggered which will push your changes to the live documentation site
-
if you wish to test your changes locally you can follow the DOCFX Installation guideline and build the entire solution locally
-
Our documentation automatically fills in the product name and other details so you don't have to make the changes manually if we decide to update the product name. Use the 'var:VariableName' construct to tell our documentation engine to fill in the info for you. Here are the constructs available at this point:
<var:ProductName> - The product name, for example mantra <var:ProductNameWithEdition> - The official product release name including the edition, for example 'mantra 2021'