This issue tracks the progression of packages in ament_index 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:

• ament_index_cpp

Excluded for Quality Level 1 at this time:

• ament_index_python

Progress of ament_index_cpp:

• Version Policy
  • Follows ROS Core Quality Declaration
• Version >= 1.0.0
• Change Control Process
  • Recommended guidelines for ROS Core packages in the ROS 2 Developer Guide
• API and ABI stability within a ROS distribution
• Vulnerability Disclosure Policy

Documentation

• Per-feature documentation.
• Per-item documentation in public API.
  • Docstrings, not hosted in API Docs.
• Declared set of licenses
• Copyright statement in each source file
  • Checked with ament_copyright
• Quality Declaration document

Testing:

• System tests, which cover "features"
• Tests covering public API
• Code Coverage > 95%:
  • • Must have code coverage tracking for the package -> here
  • • Must have and enforce a code coverage policy for new changes Policy
• Performance tests: not currently available.
• Linters and Static Analysis:
  • • Must have a code style and enforce it.
  • • Must use static analysis tools where applicable:
      -- See Linters ROS 2 Developer Guide

Dependencies:

• Runtime "ROS" dependencies are level 1
  • None
• non-ROS dependencies are equivalent level 1
  • None

Platform Support

• Supports all tier 1 platforms as described in REP-2000