ROS/Reviews/2010-01-19_Doc_Review

Reviewer:

  • kwc

Instructions for doing a doc review

See DocReviewProcess for more instructions

  1. Does the documentation define the Users of the Stack, i.e. for the expected usages of the Stack, which APIs will users engage with?
    • kwc: yes
  2. Are all of these APIs documented?
    • kwc: yes
  3. Do relevant usages have associated tutorials?
    • kwc: lots!
  4. Have all Packages in the Stack been API reviewed?

    • kwc: yes
  5. Does the Stack conform to the StackDocumentation guidelines?

  6. Are there Packages in the Stack that don't belong
    • kwc: in the future, the ROS stack will need to be split into multiple components so that GUI-related dependencies do not contaminate stack. Also, in the long-term, thirdparty dependencies should be migrated to rosdeps. Other stacks, like rosbrowse and rosmanual have been removed.

Concerns / issues

kwc

  • need to finish doc review on message_filters
  • installation page continues to be a work-in-progress and will change with debian-based installation
  • long-term: resurrect rosmanual to collect ROS-core documentation in a linear presentation
  • long-term: improve documentation on implementing a client library

mwise

Conclusion

Wiki: ROS/Reviews/2010-01-19_Doc_Review (last edited 2010-01-23 00:34:01 by MeloneeWise)