227 workflow add checks on cpp documentation

[geurto]

Description

This PR adds doxygen-style documentation checks for C++ code. Specifically, it adds

• a shell script to recursively check documentation foramtiing on all .cpp/.h/.hpp files in ros2_ws/src;
• a pre-commit check that executes the shell script mentioned above;
• a GitHub workflow that runs the script when a push is done to main, or a pull request is made;
• an update to the clang-format workflow, which was giving an error;
• code documentation in moveit_manager.hpp to adhere to Doxygen documentation standards;
• updated documentation.

Fixes: #227

Testing

• ran the script with correct and incorrect documentation;
• ran the pre-commit check with correct and incorrect documentation;
• ran the GitHub workflow locally using act with correct and incorrect documentation.

Documentation

• I have updated the documentation (if necessary)

Additional Notes

The doxygen linter fails in pre-commit checks when no output is produced (the GENERATE_<...> values in doxyfile.lint). Therefore, RTF output is generated to pass the check. The generated files are added to the .gitignore.

[Jelmerdw]

Don't forget to sign off you commits. A DCO workflow runs automatically on all repos on alliander-opensource and fails when you don't sign off your commits.

[rosalievanark]

Previously instead of using /**< ... */ I simply used // ..., is the /**< ... */ version the neater way of commenting behind a variable?

[geurto]

In order for Doxygen to recognize the comment as a docstring, it needs to be formatted a certain way. See: https://www.doxygen.nl/manual/docblocks.html