Skip to content

Documentation Standards & Guidelines

Gerry Kavanagh edited this page Jul 6, 2020 · 3 revisions

General Style Guidelines

    1. Language should be English
    1. Style should tend more toward "user manual" than "blog post".
    1. Images should (where possible) be located in the wiki git repository in 'img/'.

Page Structure

Applications Pages

Applications Pages should adhere to he following structure:

High Level Description

This is a brief description of the Application. Limit to 3 or 4 sentences. No need for elaboration of terms or definitions.

User Interface

What the various regions and controls on the UI do. This should contain a screenshot with the various regions highlighted.

Functionality

Detailed description of the usage of the application.

Examples

Specific use-cases. Possible inclusions - sample file outputs, screenshots etc.

Start here

How to collaborate
How to ask questions correctly

User manual

Developer Manual

Clone this wiki locally