Ask Your Question
1

How to document ROS2 C++ package source code?

asked 2018-08-19 13:40:55 -0500

thinwybk gravatar image

updated 2018-08-20 02:57:36 -0500

What's the current best practice to document ROS2 (Bouncy, colcon build) C++ package source code? (According to ros2doc templates it seems like the sphinx extension breathe is used to post process doxygen generated docs.)

edit retag flag offensive close merge delete

Comments

That's still the plan I think. For now, I'd just use doxygen with c++ and if you want create a doxygen file in your project so it can generate documents you can do that, but what's in it may need to change in the future.

William gravatar image William  ( 2018-08-21 10:27:08 -0500 )edit

1 Answer

Sort by ยป oldest newest most voted
1

answered 2018-08-20 20:00:51 -0500

Geoff gravatar image

There is not yet any defined best practice on documenting ROS2 packages. The ROS2 style guide does give some information on what should be in the documentation, but it does not prescribe a format. Use what you are familiar with, what is easy to maintain, and what produces good, readable documentation.

edit flag offensive delete link more

Comments

The main thing I am interested in is integrating nicely with the future ROS2 API build infrastructure which will generate http://docs.ros2.org/api/ (not existing yet).

thinwybk gravatar image thinwybk  ( 2018-08-21 01:47:01 -0500 )edit
1

If you are looking to be compatible with something that does not exist yet, then I don't think there's any answer that will help you. I suggest you use what you've already found, since they are common tools, and update when necessary.

Geoff gravatar image Geoff  ( 2018-08-21 16:39:37 -0500 )edit
2

Usually some people have already something in mind which is not public yet. I just tried to get this Info already. As you said sticking to something common and migrating if necessary is a good idea.

thinwybk gravatar image thinwybk  ( 2018-08-22 01:46:20 -0500 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Question Tools

2 followers

Stats

Asked: 2018-08-19 13:40:55 -0500

Seen: 238 times

Last updated: Aug 20 '18