You are at:
Home » Manual » Development » Coding conventions
General, C++
- For C++ source codes, use only
*.h
and *.cpp
filename extensions
- Names of classes, structures and type definitions should be in upper CamelCase notation, e.g. “EventDispatcher”. Avoid the usage of underscore (‘_’) character.
vrecko
- Always create an example batch file along with example XML file(s) when creating a new ability or plug-in.
- When creating/modifying an ability/plug-in, create a PDF document which contains the following info:
- Description of the ability (plug-in).
- Instructions which cover the basic usage.
- List of files (source codes, XML files, media resources, etc.) on which the functionality of the ability (plug-in) is dependent.
- Use spaces (instead of tabs) for indentation.
Documentation
- Create documentation for every class you create.
- Write all documentation in English, using Javadoc/Doxygen syntax.
- Place the documentation in header files, next to the class/method declarations.
- Use an appropriate amount of individual commentaries inside of method definitions.