summaryrefslogtreecommitdiffstats
path: root/doc/development/docstyleguide.txt
blob: 401a43bc00f058b120fc44be0e9791cd8b1c09b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
.. -*- mode: rst -*-

.. _doc-styleguide:

Documentation Style Guide for Bcfg2
===================================

This is a style guide to use when creating documentation for Bcfg2. It is meant to be helpful, not a hinderence.

Basics
------

:Bcfg2:
    When referring to project, Bcfg2 is the preferred use of cases.

:Monospace fonts:
    When referring to commands written on the command line use monospace fonts.

:Repository:
    When used alone this refers to a Bcfg2 :term:`repository`. When there is a chance for confusion, for instance in documents also talking about :term:`VCS`, be sure to use the longer Bcfg2 :term:`repository`.