Linux Training Materials Project - Contributing

Whether you are submitting original or modified text to the Linux Training Materials Project, please follow the Guidelines for Content, Structure and Style outlined below. Whilst we appreciate that some authors may dislike using LaTeX, we simply do not have the resources to support multiple document formats at this time.

Modifications

If you would like to contribute corrections or enhancements to existing course modules in the Linux Training Materials Project, send a copy of the new text to the original author (alteration to modules contributed by GBdirect should be sent to [email protected].

The new text should include the following ('commented out'):

• Exact copies of the original text blocks you have replaced with your own.
• Full descriptions of how you believe your own changes correct or enhance the original text blocks.

Original Modules

New modules, or requests for other people to write specific modules should be sent to [email protected].

Apart from adhering to our Guidelines for content, structure and style we ask potential authors to think very carefully about the usefulness of any modules or courses they submit.

To avoid unnecessary duplication, please take a good look at our modules (accessed via the News menu item), before you begin writing. If you have expertise in the area of a proposed module, please consider collaborating with the proposers and/or other contributors.

Guidelines for Content, Structure and Style

Content

Unless it is submitted as part of an entire course (e.g. Perl Programming for Linux), or follows on from existing modules in the Linux Training Materials Project, the content of each module should be as self-contained as possible.

Modules which do assume some prior knowledge should state their pre-requisites in the format outlined on our current releases page.

Each module should contain approximately 20-25 pages of very brief bullet-pointed lecture notes; leaving detailed explanation to the instructor. In general, individual pages should contain no more than 4-6 bullet points.

Each module should be followed by graduated exercises to which more or less practical session time can be given, depending on the length of the overall course and the ability of the students. Ideally, the practical exercises should last for twice as long as the talk, but this will not be appropriate for all topics.

Structure and Style

One of the principal reasons for writing documents in XML is to relieve authors and editors of any responsibility for designing or maintaining consistent structure and style. Authors simply specify the logical function of a particular text block, using our XML tag set (detailed in our DTD - vailable on request). N.B. Our XML tag set trys to remain close in style and usage to its XHTML antecedents.