beesuiteacademy / documentation

Repo that contains documentation for the Mojaloop project.

Mojaloop Documentation

This is the official documentation for the Mojaloop project.

Published at: docs.mojaloop.io

Building and testing locally

# install npm dependencies
npm ci 

# run the local server
npm run dev

Building the project

Run npm run build to build the project to render the static vuepress site for a deployment.

Rebuild all Puml -> svg

For consistent rending of sequence diagrams, we build the .puml sources to .svgs using the following script.

This script requires docker to be installed and running, since it uses a docker container to run the plantuml server.

# render all plantuml sources to svg files deterministically
./scripts/_build_plantuml.sh

# render just one file at a time, e.g. `figure1.plantuml`
PUML_MATCH="figure1.plantuml"  
./scripts/_build_plantuml.sh

This also ensures that the sequence diagrams are easily readable inline in markdown documents.

This script also runs as a git commit hook, so any changes added to puml sources are automatically rendered to svg without you having to do anything!

If you want to skip the commit hook, you can always run git commit -n

Versioning

We use vuepress-plugin-versioning to help us keep older versions of our docs for posterity. By default, when you browse the docs, you see the latest published version. Pending changes in the main/master branch are viewable under the versioning tab in the top navigation bar.

See https://titanium-docs-devkit.netlify.app/guide/versioning.html for more information on the plugin.

We are working to automate this process, but for now, you can make a new version of the docs with the following:

./node_modules/.bin/vuepress version docs <version number>

Known issue: sidebar not appearing in older versions Go to ./website/versioned_docs/<version number>/sidebar.config.json And remove the /next at the start of each entry

Deploying Manually

You can also deploy them manually, by running:

./scripts/_deploy_preview_s3.sh

Note that you need to have the aws cli, AWS access, and aws-mfa set up on your machine for this to work.

Contributing to the project

Please refer to the Contributing Guide for details on how to contribute to Mojaloop Docs 2.0.

License

Apache License. Version 2.0 See ./license for more information.