The Mapperly documentation is built using Docusaurus 2
and is located in the
Docusaurus is based on the node ecosystem.
.node-version file provides the node version number to be used.
This file can be interpreted by several node version managers (eg. fnm or nvm).
Make sure you use a node version matching the version in
.node-version for all following commands.
To install documentation dependencies run:
Update generated documentation
To build the generated parts of the documentation
(eg. the API documentation (located in
docs/99-api), the table of analyzer rules, the samples, ...)
ensure the dotnet solution is built or run
dontet build in the solutions root directory.
Then run the prebuild script:
npm run prebuild
To reflect changes, this command needs to be re-run each time the source of the generated output changes.
npm run start
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. The documentation search does not work when using the local development server, as it depends on the statically built content (see build).
To run the linters locally run:
npm run lint
To fix detected issues automatically run:
npm run fix
npm run build
This command generates static content into the
and can be served using any static contents hosting service or locally using
npm run serve.