Skip to content

Documentation repository for merginmaps.com/docs

License

CC-BY-4.0, MIT licenses found

Licenses found

CC-BY-4.0
LICENSE
MIT
LICENSE-CODE
Notifications You must be signed in to change notification settings

MerginMaps/docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,111 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Deploy PROD Status PROD Deploy DEV Checks

Mergin Maps Documentation

Source code for documentation hosted on merginmaps.com/docs

Use GitHub Pull Requests to propose changes, we will review and merge your changes!

Join our community chat
and ask questions!

Development

  • Create Pull Request to main branch
  • If you have changed any anchors/deleted pages atc, update REDIRECTS file
  • Core Documentation team will review the Pull Request
  • Request will be merged to main and you can check it on staging deployment
  • After repository is tagged, it is going live on live

Release procedure

  • Double check that staging deployment is what you want
  • Create Docs Release
  • Ask sys-admin to manually deploy REDIRECTS to njinx
  • Check that live is what you want and announce the news on Slack

Dynamic server (for local development)

To change docs locally, run the server, open http://localhost:8080/ in your browser and modify markdowns

cd merginmaps/docs
yarn install
yarn dev

You can also spin-up a node Docker container using the provided compose file

docker compose up mm-docs

The minimum required version of Node.js is 18.

Translations

At the moment we do not support translations, see #133

Static generation (for deployments)

To generate static HTML files, run

cd merginmaps/docs
yarn install
yarn build

and see the result in dist folder

License

The Mergin Maps product documentation in the src are licensed under a CC-BY license.

All other code in this repository is licensed under a MIT license.