This website uses browsing/session and functional cookies to ensure you get the best experience. Learn More

Writing new documentation

From Wiki for iCub and Friends
Jump to: navigation, search

Please take documentation seriously. Writing good documentation helps other people (and yourself) to understand your code. It greatly increases the possibility that others will use your modules.

Contents

Writing the documentation

Use Doxygen to write the documentation. The minimal requirement is that you document modules and applications (see below). You should also document interface classes and methods.

We suggest you take some time to learn how to use Doxygen. Section 11.1 of the manual provide some guidelines for documenting your code.

The documentation is automatically parsed and posted here: http://wiki.icub.org/iCub.

Documenting modules and applications

We provide templates for documenting modules and applications.

Modules

Use this template: http://wiki.icub.org/iCub/main/dox/html/module_documentation.html

Copy and paste this template in your module's main.cpp (or equivalent). Your module will soon appear in the list of the iCub modules at http://wiki.icub.org/iCub.

Applications

Use this template: http://wiki.icub.org/iCub/main/dox/html/application_documentation.html

Copy and paste this template in a file called 'doc.dox, place this file in the main directory of your application (in $ICUB_ROOT/app). Your application will soon appear in the list of the iCub applications at http://wiki.icub.org/iCub.

Personal tools
Namespaces

Variants
Actions
Navigation
Print/export
Toolbox