2.2 Authoring Guidelines

For this manual to hang together and make sense to the new user at whom it is targeted, contributors need to stick to a consistent style. If you plan to contribute content, you should take some time to read the existing sections — note that many of these are skeletal and the first contributions will be to flesh these sections out.

If you are familiar with texinfo, go ahead and mark up your content using texinfo. If you are not, simply author the documentation you create as plain formatted ASCII. If you do submit files as texinfo source, make sure to validate them at your end first by running the files through makeinfo — badly created or malformed texinfo source takes more time to fix than marking up straight text.