Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding doxygen documentation and READMEs to packages #204

Merged
merged 3 commits into from
Apr 24, 2020

Conversation

brawner
Copy link
Contributor

@brawner brawner commented Mar 25, 2020

Completing the API documentation of rmw. I tried to research as much as I could through rcl and rcutils packages which this package borrows from as well as design.ros2.org documentation.

One question I had for the maintainers was whether items that were strictly defined to a corresponding element in rcutils should have documention, or just link to rcutils documentation? For those, I copied the existing comments, but that does create two locations where that documentation has to be maintained.

Signed-off-by: Stephen Brawner brawner@gmail.com

Copy link
Contributor

@ahcorde ahcorde left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add [in] [inout] [out] in \param

There are some conflicts

rmw/include/rmw/rmw.h Outdated Show resolved Hide resolved
@brawner brawner force-pushed the documentation_readme branch 2 times, most recently from 647a1cd to f6b581f Compare April 23, 2020 20:36
@brawner
Copy link
Contributor Author

brawner commented Apr 23, 2020

Thanks for the feedback @ahcorde. Should be addressed.

@brawner
Copy link
Contributor Author

brawner commented Apr 23, 2020

CI status:

  • Linux Build Status
  • Linux-aarch64 Build Status
  • macOS Build Status
  • Windows Build Status

Copy link
Contributor

@ahcorde ahcorde left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - Fix conflicts with master

Signed-off-by: Stephen Brawner <brawner@gmail.com>
Signed-off-by: Stephen Brawner <brawner@gmail.com>
Signed-off-by: Stephen Brawner <brawner@gmail.com>
@ahcorde ahcorde merged commit 8229a77 into ros2:master Apr 24, 2020
@brawner brawner deleted the documentation_readme branch April 24, 2020 21:19
@dirk-thomas dirk-thomas mentioned this pull request Apr 24, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants