X-Git-Url: http://git.lttng.org./?a=blobdiff_plain;f=contrib-guide.md;h=5ae90797f85a603b33272795c9ff54fd1354ac1f;hb=e70fc4f424bbefc42f46a7aa0c015e201352e897;hp=f3cd76b646926826b75b652b4c36e7eae0446f26;hpb=89415a666d7aeec1e384459a78753253dfb21912;p=lttng-docs.git
diff --git a/contrib-guide.md b/contrib-guide.md
index f3cd76b..5ae9079 100644
--- a/contrib-guide.md
+++ b/contrib-guide.md
@@ -6,7 +6,7 @@ Documentation's source. Make sure you read it thoroughly before
contributing a change.
-branches
+Branches
--------
The online documentation published at is always
@@ -15,7 +15,7 @@ The `master` branch contains the current documentation of the upcoming
LTTng release.
-structure of sources
+Structure of sources
--------------------
`toc/docs.yml` is a YAML tree of all chapters, sections and subsections.
@@ -54,7 +54,7 @@ Run it from the repository's root:
and it will potentially output a list of errors and warnings.
-format of sources
+Format of sources
-----------------
The sources are made of a fusion of Markdown and HTML processed by
@@ -72,7 +72,7 @@ document. If you need to contribute, please use them when needed to
preserve the document's visual consistency.
-#### tip/note block
+#### Tip/note/warning/error blocks
Tip/note block:
@@ -91,7 +91,8 @@ Tip/note block:
Title should be `Tip:` for a tip and `Note:` for a note.
-#### external links
+
+#### External links
Internal links should always use Markdown
(`[caption](#doc-section)`). External links, however, need a special
@@ -108,7 +109,7 @@ In these cases, add the `int` CSS class as a hint to prevent the static
analyzer from complaining (`tools/checkdocs.py`).
-#### abbreviations
+#### Abbreviations
Use `` for describing abbreviations. This should only be used
for the first use of the abbreviation:
@@ -119,7 +120,7 @@ project is an open source system software package [...]
```
-#### non-breaking spaces
+#### Non-breaking spaces
Sometimes, a non-breaking space HTML entity (` `) needs to be
explicitly written.
@@ -135,7 +136,7 @@ A check is performed every 3000 ms.
```
-#### placeholders in inline code
+#### Placeholders in inline code
You must use `` to emphasize a placeholder within a `` tag
because Markdown backticks (`) always render their
@@ -147,7 +148,7 @@ Name your file something_sys.c, where
```
-#### terminal boxes
+#### Terminal boxes
A terminal box, where command lines are shown, is a simple `
`
with the `term` class:
@@ -181,13 +182,13 @@ Results of commands, if needed, should be presented in a simple
-#### images
+#### Images
Use
```html
-
+
```
@@ -200,8 +201,8 @@ basic browsers:
```html
-
```
@@ -210,7 +211,7 @@ An interactive SVG object allows its text to be selected, amongst other
features.
-convention
+Convention
----------
A few rules to comply with in order to keep the text as
@@ -238,7 +239,7 @@ consistent as possible:
_we_ have an ongoing example.
-committing
+Committing
----------
If you make a change to a single contents file, prefix your Git commit