Back to all reviewers

Descriptive consistent naming

quarkusio/quarkus
Based on 3 comments
Other

Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across your codebase. This practice enhances readability and maintainability.

Naming Conventions Other

Reviewer Prompt

Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across your codebase. This practice enhances readability and maintainability.

For configuration properties and attributes:

  • Prefer full terms over abbreviations (e.g., authentication-token instead of otac)
  • Use lowercase consistently (e.g., jdk-version-latest instead of JDK-ver-latest)

For package naming:

  • Follow established naming conventions (e.g., io.<organization>.<component-name>)
  • Consider namespace conflicts when defining new package hierarchies
  • Use descriptive package names that clearly indicate their purpose

For all identifiers, choose terms that avoid ambiguity with similar concepts in your domain to prevent confusion.

Example:

# Less clear:
quarkus.http.auth.form.otac.enabled=true

# More clear:
quarkus.http.auth.form.authentication-token.enabled=true
// Less clear package structure
package io.quarkus.cache;

// More clear and consistent package structure
package io.quarkus.extension.cache;
3
Comments Analyzed
Other
Primary Language
Naming Conventions
Category

Source Discussions