Skip to content

3di | Create "About nodes" article - #7164

Open
dmarshant wants to merge 37 commits into
ros2:rollingfrom
3di-for-openrobotics:about-nodes
Open

dmarshant wants to merge 37 commits into
ros2:rollingfrom
3di-for-openrobotics:about-nodes

Conversation

@dmarshant

Copy link
Copy Markdown
Contributor

This update is part of #6826

Description

Created an About Nodes article based on information across multiple other articles.

Fixes #6826

Did you use Generative AI?

No

Additional Information

Documentation updates from 3di Information Solutions, agreed with Geoff and Tully.

Should be backported to Lyrical

@dmarshant dmarshant changed the title About nodes 3di | Create "About nodes" article Sep 8, 2026

@vmbrasseur vmbrasseur left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

👍

@kscottz kscottz left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I added a few comments. This is acceptable as is but I do feel like it could use more concrete descriptions. I added more context in a few spots.

One thing we should probably discuss is the "managed nodes" moniker. I get that the docs used "managed node" and "lifecycle node" interchangeably but I think we should shorten just pick one and stick with it.

@fujitatomoya @christophebedard thoughts?

Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
@kscottz kscottz self-assigned this Sep 10, 2026
3di-for-openrobotics and others added 20 commits September 14, 2026 10:13
Co-authored-by: Katherine Scott <katherineAScott@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Katherine Scott <katherineAScott@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Katherine Scott <katherineAScott@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Katherine Scott <katherineAScott@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Katherine Scott <katherineAScott@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Co-authored-by: Alejandro Hernández Cordero <ahcorde@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
dmarshant and others added 3 commits October 8, 2026 10:43
Co-authored-by: Tomoya Fujita <tomoya.fujita825@gmail.com>
Signed-off-by: 3di Information Solutions <openrobotics@3di-info.com>
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
Comment thread source/ROS-Framework/About-Nodes.rst Resolved
.. redirect-from::

Concepts/Basic/About-Nodes
Concepts/Basic/About-Discovery

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Concepts/Basic/About-Discovery
Concepts/Basic/About-Discovery
ROS-Framework/nodes/About-Discovery

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The ROS-Framework/nodes/About-Discovery article no longer exists -- its content has been included in this about-nodes article instead

@dmarshant

Copy link
Copy Markdown
Contributor Author

@kscottz @fujitatomoya @ahcorde I've updated the article with your feedback, many thanks.
FYI @vmbrasseur

@ahcorde ahcorde left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

  • Missing redirect: ROS-Framework/nodes/About-Discovery is deleted, but its current URL (live on rolling and lyrical) isn't redirected.

  • "Nodes are written as subclasses of the Node class": not quite right. Nodes can be created without subclassing, and rclc (C) has no classes.

  • "Each node runs separately in its own runtime environment": the next sentence and the composable nodes section say the opposite. I'd remove it.

  • The Launch-Main.rst change seems out of scope and leaves an empty .. toctree::. Either remove the directive or move this to a separate PR.

  • Link "server-client discovery" to the Discovery Server page.

  • Summary: "behavior of nodes can be configured using parameters". Remapping, namespaces and QoS overrides configure nodes too.

@ahcorde ahcorde left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

conflicts

This branch has not been deployed

No deployments
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.

3di | Create "About" articles for the main functionality areas

7 participants