Skip to content

📖 Authoring documentation

There are 2 types of the documentation that DrevOps provides:

  1. This Documentation of DrevOps that is then deployed to https://docs.drevops.com/
  2. Consumer site documentation that is distributed when DrevOps is installed.

docs.drevops.com

The Documentation (this site) is written in Markdown and located in .drevops/docs directory. This is removed when you install DrevOps for a consumer site.

Local build

1
2
cd .drevops/docs
ahoy build

Parts of the documentation is generated automatically from the codebase. To update it, run:

1
2
3
composer -d .drevops/docs/.utils install
cd .drevops/docs
ahoy update

If you have the documentation site running locally, the updates will be seen immediately.

1
2
cd .drevops/docs
ahoy test

If required, add spelling exclusions to .drevops/tests/.aspell.en.pws file.

Publishing

An automated CI build publishes this documentation on DrevOps release (as a latest version) and on every commit to a branch that has docs string in its name. This allowa publishing documentation for feature branches.

Consumer site documentation

DrevOps provides a scaffold of the consumer site documentation in the docs directory.

After DrevOps is installed into the consumer site, these docs are intended to be used by the site maintainers and stay up-to-date with the project changes.