Skip to content

Conversation

@maxedenharter0507
Copy link
Contributor

@maxedenharter0507 maxedenharter0507 commented Sep 18, 2025

Changelog:

Update

  • Specified that digits must be avoided when using camelCase notation in "MUST use camelCase for query parameters" R000022.
  • Specified that digits must be avoided when using camelCase notation in "SHOULD use camelCase for property names" R004010.

Copy link
Contributor

@cgebken cgebken left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just some minor suggestions :) Great ADR!

@cgebken cgebken changed the title Avoid digits in camelCase feat(guidelines): avoid digits in camelCase Sep 19, 2025
maxedenharter0507 and others added 3 commits September 22, 2025 08:18
…-camel-case-for-property-names.md

Co-authored-by: Christina Framke <[email protected]>
…e-camelcase-for-query-parameters.md

Co-authored-by: Christina Framke <[email protected]>
@maxedenharter0507
Copy link
Contributor Author

Feedback from the Async API Community: In general we agree on avoiding digits in camelCase. But we also thought about common abbreviations like B2B, B2C, and E2E, which are also used in our marketplace ecosystem. As we change the rule to “avoid digits” and not "disallow digits", this should be fine for such special cases.

We should disallow leading digits in property names, as this could lead to compile errors in common programming languages like Java.

@jensfischer1515
Copy link
Contributor

LGTM, after adding more examples for DOs and DON'Ts

@maxedenharter0507 maxedenharter0507 marked this pull request as ready for review January 13, 2026 12:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants