Make related collections obvious.
Section: Naming conventions
Name relationships clearly
text
text
GET /teams/{teamId}/membersExplanation
A relationship collection should read clearly from left to right and preserve the domain meaning.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing Naming conventions
Use consistent casing in paths
Pick one URL style and use it consistently.
Avoid format suffixes in paths
Negotiate format via headers, not path suffixes.
Expose canonical resource paths
Each resource should have an obvious direct URL.
Put resource identity in the path
Use the path for the primary resource being addressed.