Choose names that are immediately understandable without requiring additional context, documentation lookup, or guessing. Identifiers should clearly communicate their purpose, units, and behavior to reduce cognitive load for developers.
For configuration settings and labels, prioritize descriptive language over technical jargon. When technical terms are necessary, pair them with plain language explanations. For time-based or measurement settings, include units directly in the name to eliminate ambiguity.
Examples:
pending_users_reminder_delay_minutes over pending_users_reminder_delayThis approach prevents developers from having to guess units, look up documentation, or decipher technical terminology, leading to more maintainable and accessible code.
Enter the URL of a public GitHub repository