Skip to content

Latest commit

 

History

History
81 lines (55 loc) · 3.29 KB

README.md

File metadata and controls

81 lines (55 loc) · 3.29 KB
Raw

Checks Deploy DEV Status DEV Deploy PROD Status PROD

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

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

Error for nodejs 17

If you get opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ], run

export NODE_OPTIONS=--openssl-legacy-provider

or on Windows

set NODE_OPTIONS=--openssl-legacy-provider

or downgrade nodejs to 16 or less. More here: webpack/webpack#14532

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.