domains / / quarkusio/quarkus
Descriptive consistent naming
Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across your codebase. This practice enhances readability and maintainability.
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-tokeninstead ofotac) - Use lowercase consistently (e.g.,
jdk-version-latestinstead ofJDK-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;