Awesome Reviewers expert instructions

domains / / boto/boto3

Avoid identifier name stuttering

Do not repeat the resource name in identifier names. This form of stuttering makes code less readable and inconsistent. Instead, use simple, descriptive identifiers without redundancy.

raw .md Naming Conventions Json

Do not repeat the resource name in identifier names. This form of stuttering makes code less readable and inconsistent. Instead, use simple, descriptive identifiers without redundancy.

For example:

  • Use Id instead of VpnGatewayId for a VpnGateway resource
  • Use Name instead of ReportName for a ReportDefinition resource

When necessary, include a memberName attribute to map the simplified identifier to the actual API field name:

"identifiers": [
  { 
    "name": "Id", 
    "memberName": "VpnGatewayId"
  }
]

This approach creates more concise and consistent identifiers throughout the codebase while maintaining the correct mapping to external API representations.