https://index.ros.org/doc/ros2/Releases/Release-Dashing-Diademata/#rclpy recommends using qos_profile_sensor_data for subscribers. I could not find qos_profile_sensor_data on the rclpy QoS doc page.

There are some constants along with qos_profile_sensor_data defined on https://github.com/ros2/rclpy/blob/22816b41f66bcdb20adcca0b92fb7c8149710297/rclpy/rclpy/qos.py#L421

It would be great that these convenient constants are included in the documentation. The developer's ignorance of qos_profile_sensor_data leads to code as follows:

self.subscription = self.create_subscription(
            LaserScan,
            'scan',
            self.listener_callback,
            QoSProfile(depth=10, reliability=ReliabilityPolicy.BEST_EFFORT))

As far as I understand the following does the same:

self.subscription = self.create_subscription(
            LaserScan,
            'scan',
            self.listener_callback,
            qos_profile_sensor_data)

There are no relevant results when Googling "sensor_msgs foxy ros2", not even for "site:docs.ros2.org sensor_msgs". The docs actually do exist at http://docs.ros2.org/foxy/api/sensor_msgs/index-msg.html, along with all the other official message packages. Nothing links to these pages or they would be indexed by Google, and even their URL is hard to guess (you might try index.html but not index-msg.html). index.ros.org also links to http://docs.ros2.org/foxy/api/sensor_msgs/ which gives a 404 error. So no one knows they exist and is left to guess whether the ROS1 docs still apply – including me until I looked at this repo.

I propose generating a http://docs.ros2.org/<distro>/api/index.html which lists all the packages, and linking to that one from the main http://docs.ros2.org/<distro>/index.html page. Additionally, either the name of the package documentation should be changed to index.html or the links in index.ros.org be adjusted.

I can take a stab at the first item although I don't really know Sphinx and Doxygen well, I'll let you know how it goes.

There is no top level LICENSE file.
What license are these docs under?
The CC-BY-4.0 license makes the most sense for docs like this.

Hi,

I stumbled on this website and it seems that alot of the content here is a slightly different mirror of content that is either on the Index website or should be on the index website for ROS2 overviews.

Is the intent to have this be a separate website, or is this just content that didn't get migrated over? The ROS2 API diagrams are some of the key things on this website that I think should be reflected on the Index to beginners (e.g. http://docs.ros2.org/eloquent/developer_overview.html#internal-api-architecture-overview).

Edit: To be clear, I'm open to migrating this myself if that's in line with what folks think should be done.

Apologies in advance if this is the wrong place to post this fairly minor point, but I noticed that many (if not all) of the Quality Declaration files for core ROS packages have a dead link to a ROS2 Onboarding Guide.

Full excerpt from Coverage [4.iii]:
Current coverage statistics can be viewed here. A description of how coverage statistics are calculated is summarized in this page "ROS 2 Onboarding Guide".

A few examples:
rcl
rclcpp
rmw

Has this guide moved somewhere else or should the reference to it be removed altogether? Is there a better document that we should direct new users (like myself) to, to learn how coverage statistics are calculated?

Thanks!

Checking the Makefile branch doc_gen I noticed that some packages are being built.

@nuclearsandwich or @wjwwood why is this needed? Just Building the Doxyfile or/and Sphinx should be enough, right?