Progress toward Quality Level 1

[brawner]

This issue tracks the progression of packages in rcl_interaces that have been deemed necessary for Quality Level 1 and a 1.0 version level. It follows the outline described in REP 2004.

The packages slated for Quality Level 1 for ROS 2 Foxy are:

• action_msgs
• builtin_interfaces
• composition_interfaces
• lifecycle_msgs
• rcl_interfaces
• rosgraph_msgs
• statistics_msgs

Excluded for Quality Level 1 at this time:

• test_msgs

Progress common to all packages:

• Version Policy
  • Follows ROS Core Quality Declaration
• Version >= 1.0.0
• Change Control Process
  • Follows ROS Core
• No testing required because these packages just define messages and services

Documentation

• Declared set of licenses
• Copyright statement in each source file
  • Copyright statements aren't needed in msg/srv files

Dependencies:

• non-ROS dependencies are equivalent level 1

Platform Support

• Supports all tier 1 platforms

Progress of specific packages

action_msgs

Documentation

• Per-feature documentation.
  • This feature documentation should also point to http://design.ros2.org/articles/actions.html
• Per-item documentation in public API.
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • rosidl_default_runtime
  • builtin_interfaces
  • unique_identifier_msgs
• non-ROS dependencies are equivalent level 1

builtin_interfaces

Documentation

• Per-feature documentation.
• Per-item documentation in public API.
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • rosidl_default_runtime

Specific comments/recommendations:

• Time.msg:
  • int64 for seconds (see Time.msg is subject to year 2038 problems #85)
  • sec -> seconds
  • nanosec -> nanoseconds

composition_interfaces

Documentation

• Per-feature documentation.
• Per-item documentation in public API.
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • rosidl_default_runtime
  • rcl_interfaces

lifecycle_msgs

Documentation

• Per-feature documentation.
  • Should also point to lifecycle nodes documentation
• Per-item documentation in public API.
  • Needed in (ChangeState.srv, GetAvailableStates.srv, GetAvailableTransitions.srv, GetState.srv)
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • rosidl_default_runtime

rcl_interfaces

• Per-feature documentation.
• Per-item documentation in public API.
  • See below
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • builtin_interfaces
  • rosidl_default_runtime

rosgraph_msgs

Documentation

• Per-feature documentation
  • ROS 1 feature level docs exist
• Per-item documentation in public API.
• Quality Declaration document

Dependencies:

• Runtime "ROS" dependencies are level 1
  • builtin_interfaces
  • rosidl_default_runtime

[chapulina]

All packages are level 1 😄 #116