Update documentation of PID class (backport #388)

[mergify]

Documentation PR post-PR #298 merge

---

This is an automatic backport of pull request #388 done by [Mergify](https://mergify.com).

[mergify]

Cherry-pick of ff1f2d6 has failed:

On branch mergify/bp/jazzy/pr-388
Your branch is up to date with 'origin/jazzy'.

You are currently cherry-picking commit ff1f2d6.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Changes to be committed:
	modified:   control_toolbox/include/control_toolbox/pid.hpp
	modified:   doc/control_toolbox.md

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   doc/migration.rst

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 76.76%. Comparing base (ba3ac2c) to head (93a8348).

Additional details and impacted files

@@           Coverage Diff           @@
##            jazzy     #423   +/-   ##
=======================================
  Coverage   76.76%   76.76%           
=======================================
  Files          29       29           
  Lines        1945     1945           
  Branches      114      114           
=======================================
  Hits         1493     1493           
  Misses        379      379           
  Partials       73       73           

Flag	Coverage Δ
unittests	76.76% <ø> (ø)

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

Files with missing lines	Coverage Δ
control_toolbox/include/control_toolbox/pid.hpp	66.98% <ø> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.