This website is built using Docusaurus 2, a modern static website generator.
cd website
yarncd website
yarn startThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
First, install Ruby gems used for markdown generation in scripts folder:
cd scripts
bundle installMost of the markdown is generated using Ruby templates. You should never update the markdown files - instead, update the Ruby template file.
Markdown is generated using ERB (Embedded RuBy).
Instead of editing .md files directly, remember to apply your changes to some_doc.md.erb and
then generate markdown by running make generate USE_CONTAINER=none in the root folder
of the documentation repository.
Running make generate USE_CONTAINER=none will apply your changes to all affected markdown files. The make command should be executed in the root folder of this repository.
Commit, push & create a PR after running the make generate USE_CONTAINER=none with markdown files generated by the templating system.
If you want to have live update writing (the web ui is updated on any save), you can use this:
./scripts/live_update.sh
To update the Getting Started page in the docs, update the website/docs/getting-started.md.erb instead of website/docs/getting-started.md file (see the difference in .erb file extension).
After making changes to the template, run make generate USE_CONTAINER=none in the root folder of the repository. The last step - commit and push your changes, open a PR, and wait for your changes to go live!
Want to help the community and? Contribute to Qovery documentation! Qovery Community plan is charged by contributions to the community - you can get free credits to host your applications by contributing in many ways - including by writing or fixing the docs!
Learn more about our system: