Skip to content

Update documentation post-PR #298 merge #388

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: ros2-master
Choose a base branch
from

Conversation

ViktorCVS
Copy link
Contributor

Documentation PR post-PR #298 merge

Clarify and expand migration instructions now that pull request ros-controls#298 has
been merged, ensuring users know how to adjust their configurations
accordingly.
@ViktorCVS
Copy link
Contributor Author

@christophfroehlich I’ve created a PR to update the documentation, but I’m not sure if there are other repositories or files I need to update. Can you help me with that?

@codecov-commenter
Copy link

codecov-commenter commented Jun 7, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 76.72%. Comparing base (0336ef4) to head (2b290b0).

Additional details and impacted files
@@             Coverage Diff              @@
##           ros2-master     #388   +/-   ##
============================================
  Coverage        76.72%   76.72%           
============================================
  Files               30       30           
  Lines             1744     1744           
  Branches           107      107           
============================================
  Hits              1338     1338           
  Misses             346      346           
  Partials            60       60           
Flag Coverage Δ
unittests 76.72% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@christophfroehlich
Copy link
Contributor

@christophfroehlich I’ve created a PR to update the documentation, but I’m not sure if there are other repositories or files I need to update. Can you help me with that?

I suggest that you add the documentation here
https://github.com/ros-controls/control_toolbox/blob/ros2-master/doc/control_toolbox.md
which will be published here
https://control.ros.org/rolling/doc/control_toolbox/doc/index.html

Add a new section for the PID, copy basis information from the docstring and add your antiwindup description from the other PR there.

ViktorCVS and others added 3 commits June 12, 2025 10:31
Adds a comprehensive PID section to control_toolbox.md, covering the
standard PID equation, descriptions of proportional, integral, and
derivative gains, output limits, detailed explanations of anti-windup
strategies (back-calculation and conditional integration) with update
rules and default values, and a C++ usage example.
Clarify and expand migration instructions now that pull request ros-controls#298 has
been merged, ensuring users know how to adjust their configurations
accordingly.
@ViktorCVS ViktorCVS marked this pull request as ready for review June 13, 2025 13:40
@ViktorCVS
Copy link
Contributor Author

@christophfroehlich I’ve created a PR to update the documentation, but I’m not sure if there are other repositories or files I need to update. Can you help me with that?

I suggest that you add the documentation here https://github.com/ros-controls/control_toolbox/blob/ros2-master/doc/control_toolbox.md which will be published here https://control.ros.org/rolling/doc/control_toolbox/doc/index.html

Add a new section for the PID, copy basis information from the docstring and add your antiwindup description from the other PR there.

Done! I changed it from draft to open. If there is still documentation to add, I’ll add more commits.

Adds a comprehensive PID section to control_toolbox.md, covering the
standard PID equation, descriptions of proportional, integral, and
derivative gains, output limits, detailed explanations of anti-windup
strategies (back-calculation and conditional integration) with update
rules and default values, and a C++ usage example.
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.

3 participants