Fix motion_primitive_controller TOC in docs

[SouriRishik]

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]

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]

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]

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

[christophfroehlich]

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]

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]

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

[SouriRishik]

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

[SouriRishik]

@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.

[thedevmystic]

LGTM