feat: update the naming rules for directories and classes

[xmfcx]

Description

Previous discussions:

• Prefix packages with autoware_ prefix and keep code in autoware namespace autoware#4569
• https://github.com/orgs/autowarefoundation/discussions/4097

As we are prefixing the packages with autoware_, we needed to clear the rules to avoid confusion.

Using or omitting the autoware_ prefix or _node suffix can be highly confusing without clear guidelines.

Pre-review checklist for the PR author

The PR author must check the checkboxes below when creating the PR.

• I've confirmed the contribution guidelines.
• The PR follows the pull request guidelines.

In-review checklist for the PR reviewers

The Reviewers must check the checkboxes below before approval.

• The PR follows the pull request guidelines.

Post-review checklist for the PR author

The PR author must check the checkboxes below before merging.

• There are no open discussions or they are tracked via tickets.

After all checkboxes are checked, anyone who has write access can merge the PR.

[github-actions]

Documentation URL: https://autowarefoundation.github.io/autoware-documentation/pr-547/
Modified URLs:

• https://autowarefoundation.github.io/autoware-documentation/pr-547/contributing/coding-guidelines/ros-nodes/class-design/
• https://autowarefoundation.github.io/autoware-documentation/pr-547/contributing/coding-guidelines/ros-nodes/directory-structure/
• https://autowarefoundation.github.io/autoware-documentation/pr-547/contributing/coding-guidelines/ros-nodes/parameters/

[isamu-takagi]

Thank you for updating. I felt the rules were too strict in some parts. I think it would be nice if the maintainer could have a little more freedom in designing the inside of the package.

[esteve]

@xmfcx thanks for writing this up. I'd go a bit further and make all this mandatory (i.e. not should, but must). The more uniform the packages are, the easier they'll be to read, debug and fix issues.

[esteve]

@xmfcx LGTM, thanks for addressing my feedback.

[xmfcx]

Thanks everyone for your reviews!

I will merge this as 4 developers have reviewed it already.

If anyone wants to change some part of it, they can open a new PR.