contributing a change.
-structure
----------
+branches
+--------
+
+The online documentation published at <http://lttng.org/docs/> is always
+compiled from the sources of this repository's latest stable branch.
+The `master` branch contains the current documentation of the upcoming
+LTTng release.
+
+
+structure of sources
+--------------------
`toc/docs.yml` is a YAML tree of all chapters, sections and subsections.
It indicates which unique ID is linked to which position in the
```html
<div class="img img-70">
- <img src="/images/docs/image-name.png" alt="Short description">
+ <img src="/images/docs26/image-name.png" alt="Short description">
</div>
```
```html
<div class="img img-90">
- <object data="/images/docs/image-name.svg" type="image/svg+xml">
- <img src="/images/docs/image-name.png" alt="Short description">
+ <object data="/images/docs26/image-name.svg" type="image/svg+xml">
+ <img src="/images/docs26/image-name.png" alt="Short description">
</object>
</div>
```
* Keep the text as impersonal as possible (minimize the use of
_I_, _we_, _us_, etc.), except for user guides/tutorials where
_we_ have an ongoing example.
+
+
+committing
+----------
+
+If you make a change to a single contents file, prefix your Git commit
+message's first line with the file ID followed by `: `, e.g:
+
+ archlinux: minor fix