docs

docs copied to clipboard

Use :envvar: to refer to variables.

1

Refer to #140. Opened this issue here to keep track of it.

ypid

Use :linenos: for examples in defaults/main.yml to mark them as examples.

2

@drybjed noted that giving examples in `defaults/main.yml` can be confusing because in the rendered output, their markup looks exactly the same as the default value. Proposed fix: Use `:linenos:` for...

ypid

Change how documentation is built

2

At the moment, the DebOps documentation located at `http://docs.debops.org/` is built using this repository and git submodules. Unfortunately, this presents two problems: - with more and more submodules, build time...

drybjed

Just a small detail I noticed multiple times. [There are usually no spaces either before or after a slash: "male/female".](https://en.wikipedia.org/wiki/Slash_%28punctuation%29). I will fix it when I see it :wink:

ypid

decrease folder level of docs in submodules

1

Hi Maciej, I've begun to work on packaging also this repo as debops-doc package for Debian (https://bugs.debian.org/820367), but there's an obstacle with the submodules. The folders in docs/ contain the...

danstender

different levels of roles

6

As newbie user I lost orientation when refering to the roles of debobs quite often. When you look at the left sidebar on http://docs.debops.org/en/latest/index.html you will see more than a...

pniederlag