Writing Documentation

The Kolab community has a reference implementation of its releases, which can best be described as a next-next-finish installation [1] of a single node [2] running Enterprise Linux 7 [3].

For writing documentation, this means that all documented commands and file paths mentioned need to match that specific implementation [4] of Kolab installed on Enterprise Linux 7, and that every HOWTO needs to start at the aforementioned null situation.

This sounds harsh, and it probably is, but here’s how you can work with it:

  • When you create a HOWTO for something on Debian, your HOWTO should probably be titled: HOWTO: Achieve Greatness (on Debian Wheezy).

  • When you do write a generic HOWTO, you can re-iterate the commands issued for different distributions:

    After changing the configuration, restart the service:
    .. parsed-literal::
        # :command:`systemctl restart postfix`
    On Debian Wheezy, execute the following instead:
    .. parsed-literal::
        # :command:`/etc/init.d/postfix restart`