============
Conventions
============

Example Consistency
-------------------

Examples should be consistent throughout the documentation. We should standardize on a set of values/examples used, e.g.:

- Example domains: example.com, example.org, example.net
- Example hosts: foo.example.com, bar.example.com
- Example IP addresses: 192.0.2.0/24 (pick from the range 192.0.2.0 - 192.0.2.255)
- Example plugins: FIXME
- Example datasources: FIXME

`RFC2606 <http://tools.ietf.org/html/rfc2606>`_ details which hostnames are reserved for such usage.

`RFC3330 <http://tools.ietf.org/html/rfc3330>`_ details special-use IPv4 addresses.