From 723f580e5ea060b87155110ca59c7443f270cbe3 Mon Sep 17 00:00:00 2001 From: Sol Jerome Date: Tue, 23 Mar 2010 13:41:11 +0000 Subject: doc: More suggested improvements from Philipp Riegger Signed-off-by: Sol Jerome git-svn-id: https://svn.mcs.anl.gov/repos/bcfg/trunk/bcfg2@5788 ce84e21b-d406-0410-9b95-82705330c041 --- doc/development/docstyleguide.txt | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) (limited to 'doc/development/docstyleguide.txt') diff --git a/doc/development/docstyleguide.txt b/doc/development/docstyleguide.txt index 401a43bc0..fda1037f3 100644 --- a/doc/development/docstyleguide.txt +++ b/doc/development/docstyleguide.txt @@ -5,17 +5,23 @@ 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. +This is a style guide to use when creating documentation for Bcfg2. It +is meant to be helpful, not a hinderence. Basics ------ -:Bcfg2: +**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. +**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`. +**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`. -- cgit v1.2.3-1-g7c22