Skip to content

Fix motion_primitive_controller TOC in docs#2221

Open
SouriRishik wants to merge 7 commits intoros-controls:masterfrom
SouriRishik:fix/motion-primitive-controller-toc
Open

Fix motion_primitive_controller TOC in docs#2221
SouriRishik wants to merge 7 commits intoros-controls:masterfrom
SouriRishik:fix/motion-primitive-controller-toc

Conversation

@SouriRishik
Copy link
Copy Markdown

@SouriRishik SouriRishik commented Mar 20, 2026

Fixes #2216

Changes

  • Reorder controllers alphabetically in doc/controllers_index.rst
  • Fix path for Motion Primitive Controller to motion_primitives_controllers/doc/userdoc.rst
  • Move README.md and userdoc.rst into motion_primitives_controllers/doc/
  • Fix relative paths in userdoc.rst and README.md after move

This cherrypicks the fix from commit 7b2462a into master.

Checklist

  • Limited scope — only fixes the TOC issue
  • Local tests pass
  • Clear commit message

@bmagyar
Copy link
Copy Markdown
Member

bmagyar commented Mar 20, 2026

I think the PR referenced on the original issue removed the readme file. I think that may be the better option, if we are happy with the docs already in the main doc file.

If we decide to stick with the readme, it should be in the package root.

@SouriRishik
Copy link
Copy Markdown
Author

SouriRishik commented Mar 20, 2026

I think the PR referenced on the original issue removed the readme file. I think that may be the better option, if we are happy with the docs already in the main doc file.

If we decide to stick with the readme, it should be in the package root.

I agree, removing the README seems like the cleaner approach since the content is already included in the doc files. I'll update the PR to remove it instead.

@SouriRishik
Copy link
Copy Markdown
Author

Also, is the doc8 pre-commit failure on rolling a known issue or something I need to fix on my end?

@christophfroehlich
Copy link
Copy Markdown
Member

the problem is mainly the heading level in the markdown file. have a look at the linked PR in the issue. the first of my commits should point you there. tests are not failing on master branch

@SouriRishik
Copy link
Copy Markdown
Author

Done, removed the README.md and inlined the essential content directly into userdoc.rst with proper RST formatting. Please have a look. thank you!

@SouriRishik
Copy link
Copy Markdown
Author

@bmagyar are the current changes good enough for solving the issue, if yes can we merge and close the PR?

Comment thread motion_primitives_controllers/README.md
@SouriRishik SouriRishik force-pushed the fix/motion-primitive-controller-toc branch from 1b1e32a to bf9c5a3 Compare March 26, 2026 21:16
@SouriRishik SouriRishik force-pushed the fix/motion-primitive-controller-toc branch from bf2f5f8 to 2942d73 Compare March 26, 2026 21:34
Copy link
Copy Markdown
Author

@SouriRishik SouriRishik left a comment

Choose a reason for hiding this comment

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

i think what i did changes in the readme and userdoc.rst were not relevant here so i just reverted those changes

@SouriRishik
Copy link
Copy Markdown
Author

@christophfroehlich i have made the required change and also the README and userdoc.rst is now untouched so that the information is as it is.

Copy link
Copy Markdown
Contributor

@thedevmystic thedevmystic left a comment

Choose a reason for hiding this comment

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

LGTM

@SouriRishik
Copy link
Copy Markdown
Author

Hi, following up on this PR. Please let me know if there are any further changes I should make.

Copy link
Copy Markdown
Member

@christophfroehlich christophfroehlich left a comment

Choose a reason for hiding this comment

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

What is the status of this PR? now there is only the resorting in controllers_index, have you forgotten to push something?

@SouriRishik
Copy link
Copy Markdown
Author

SouriRishik commented Apr 11, 2026

What is the status of this PR? now there is only the resorting in controllers_index, have you forgotten to push something?

Hi, I thought changing the README and userdoc.rst was not necessary so I reverted that change which was done initally and only pushed resorting of controller_index. It got approval so I was just waiting until any other change was required

@SouriRishik
Copy link
Copy Markdown
Author

However, if you want I can push the changes of README and userdoc.rst which will be under the path motion_primitives_controllers/doc and not motion_primitives_controllers like how it is right now

Comment thread motion_primitives_controllers/doc/README.md Outdated
@codecov
Copy link
Copy Markdown

codecov bot commented Apr 15, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 84.68%. Comparing base (fafccb5) to head (0d82df1).
⚠️ Report is 5 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #2221      +/-   ##
==========================================
- Coverage   84.68%   84.68%   -0.01%     
==========================================
  Files         153      153              
  Lines       15318    15317       -1     
  Branches     1332     1332              
==========================================
- Hits        12972    12971       -1     
  Misses       1858     1858              
  Partials      488      488              
Flag Coverage Δ
unittests 84.68% <ø> (-0.01%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

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

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.

[Docs] motion_primitive_controller TOC is broken

4 participants