Each new feature/tool in MapStore should be documented in the User Guide in order to explain the involved functionalities and illustrate how it works.
All new front-end technologies, development procedures, best practices and guidelines on the involved components in MapStore should be properly documented too: the Developers Guide must be kept up-to-date for this.
The Developer and User guide documentation are built on the Read the Docs hosting platform. The MapStore's documentation files are available in the docs/ section of this repository; Mkdocs is used in MapStore as documentation generator, you can look at the available online documentation for more information on how to use it (MapStore uses his own customized MkDocs Material theme for both User and Developer documentations).
The documentation is built on RTD (Read the Docs) documentation hosting platform.
But in order to build it locally, there are certain steps that needs to be followed
- Python installation
- Install Python 3
Pip is automatically installed when python is downloaded from python.org, if not, follow this instruction to install pip
Install all the libraries/plugins in
docs/requirements.txtusing pip while matching the exact version present
mkdocs-material==3.2.0, the installation using pip is as follows
pip install mkdocs-material==3.2.0
Build the docs using the command
mkdocs build. This will build the documentation and puts the built files into
sitefolder and the pdf generated into
- Alternatively, the command
mkdocs servestarts the built-in dev-server, of MkDocs, that lets us preview the documentation as we work on it
- The documentation can be launched using
When creating a link to internal document (.md) files, make sure to use full link instead of a relative path to the file. As using relative path will not work in exported PDF document.
Instead of creating a link