Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/divio/divio-cloud-docs

Divio Cloud documentation for developers
https://github.com/divio/divio-cloud-docs

Last synced: 3 months ago
JSON representation

Divio Cloud documentation for developers

Awesome Lists containing this project

README

        

Divio Documentation
===================

.. image:: https://readthedocs.com/projects/divio-divio-cloud-docs/badge/?version=latest
:target: https://docs.divio.com/en/latest/?badge=latest
:alt: Documentation status

.. image:: https://github.com/divio/divio-cloud-docs/actions/workflows/default.yml/badge.svg
:target: https://github.com/divio/divio-cloud-docs/actions/workflows/default.yml
:alt: GitHub workflow status

The official documentation for Divio and its products.

Build the documentation locally
-------------------------------

You'll need the `enchant `_
library, used by ``pyenchant`` for spelling.

Install with ``brew install enchant`` (macOS) or the appropriate command for
your system.

Then::

git clone [email protected]:divio/divio-cloud-docs.git
cd divio-cloud-docs
make install
make run
open http://localhost:9001

Notable techniques used in this documentation
---------------------------------------------

* We serve our documentation via `Read the Docs `_.
* The documentation is written in ReStructed Text (RST) and built using
`Sphinx `_.
* `Intersphinx `_
to reference to other documentation.

Documentation structure and standards
-------------------------------------

Our documentation structure is key to its usability. See our
`What nobody tells you about documentation `_
system for an explanation of why it's important and how it works.

See also our `additional documentation standards
`_.