Better Doxygen API Documentation

[davetcoleman]

On ros.org we need to somehow fix our code to have its doxygen pages correctly generated. It kinda works for the MoveIt Setup Assistant but for example MoveIt Ros does not work.

Also, we should take down the old out of date doxygen stuff on this page: http://moveit.ros.org/wiki/index.php/Groovy/API

[mikeferguson]

Just came across this, an important note is that moveit_ros has no code as it is a metapackage -- for instance moveit_core is correct (http://docs.ros.org/groovy/api/moveit_core/html/) as is moveit_ros_perception (http://docs.ros.org/groovy/api/moveit_ros_perception/html/index.html)

That said, we should definitely update docs to have better mainpage dox, and the moveit_ros stuff is sparse on docs in a number of places.

[davetcoleman]

Overall we need to get MoveIt! docs back up to speed

• [ ] Make it easier for non-core developers to contribute
  • [ ] Add "Edit on Github Link": https://github.com/ros-infrastructure/rosdoc_lite/issues/53
  • [ ] Document how to document
  • [ ] Announce on mailing list
• [ ] Release pr2_moveit_tutorials to Indigo so that all the tutorials are the latest
• [ ] Finish copying contents from the old MoveIt! wiki
• [ ] Move moveit.ros.org Tutorial and Code API pages to their own Sphinx doc pages for easier editing

Of course no one has time to do all of this, so everyone's help is appreciated

[davetcoleman]

This issue is a little out of date, moving to https://github.com/ros-planning/moveit_docs/issues/25