Skip to content

Contributing documentation

arturoc edited this page Nov 23, 2011 · 8 revisions

The sources for the documentation are temporarily here

To edit them fork this repository to your own account. The actual documents are in markdown format inside the _docs forlder.

To edit them you'll need to follow this guidelines:

  • The format of the document is:
# class ofClass

## Description

description of the class

## Methods

the method of the class

## Variables

the variables of the class

When editing do not modify that headers.

Don't add new functions or variables to the documents that will be autogenerated from doxygen and have a specific format:

###void setup()

_syntax: setup()_

_name: setup_

_returns: void_

_returns_description: _

_parameters: _

_access: public_

_version_started: 006_

_version_deprecated: _

_summary: _

_constant: False_

_static: no_

_visible: True_

_advanced: False_



_description: _


This function gets called once, just at the start of the app. It would be a good place, for example, to allocate variables or load in any files. 

The fields that are marked with _field: value_ shouldn't be touched by now either

To modify the description the format is markdown, you can check the syntax here

There's some exceptions to pure markdown:

  • do not use headers like ## those are used to parse the methods and variables
  • to signal code use: $$code(lang=c++) $$/code instead of the normal markdown syntax