Developers Guide

Code style

Cpp follow ROS Cpp Style Guide rigorously.
CMake follow Caktin CMake Style Guide.
Python code should follow pep8. Please see ROS PyStyleGuide for details. Use Anaconda plugin for sublime text editor for style check.
Bash Use this python script.
Roslint All pkgs (except commons pkgs which don't have cpp or py code) depend on roslint for static code analysis.
[Note - Utils directory contains scripts for formatting cpp, python, xml, CmakeList files. Since these are bash scripts I have also added formatting script for bash]

---

(Still missing) Documentation

We maintain two forms of online documentation for ROS packages:
wiki pages / External docs: This is the AUVWiki repo. Home for tutorials and other sorts of information. This is mainly for people running your code.
auto-generated code documentation Internal docs: This is mainly for people integrating with or editing your code. Use Doxygen while documenting new code.

---

Source control

We use Git. Read the wiki page on git.

---

Bug tracking

We use github issues on auv repo for tracking bugs.

---

(Still missing) Testing

We use two level of testing:
Library: At the library level, we use standard unit-test frameworks. In C++, we use gtest. In Python, we use unittest.
Message: At the message level, we use rostest to set up a system of ROS nodes, run a test node, then tear down the system.
ROS has established best practices and policies for writing and running tests.

---

(still missing) Standardization

Code should use ROS services, follow guidelines for their use:
use rosout for printing messages
uses the ROS Clock for time-based routines

---

Large data files

Large files (anything over 1MB, really) often don't belong in the auv repositories, especially if they are just used for tests. These large files affect the time that it takes to checkout the repository.

Naming Convention

Please refer to ROS CppStyleGuide and ROS Conventions
Other than following ROS naming convention,
Topics and nodes should be names keeping in mind the ros namespace. For keeping it noob friendly, global names should be assigned to nodes and topics.
Package folder name should be same as package name.
Node file name, executable name and ros node name should be same.
Dynamic Reconfigure cfg files should be related to what it helps configuring.
Action files should be named after what action or task is done through them.
Launch files should be named after what state it will launch the nodes in.

---