Use semantically meaningful names

Choose names that clearly convey purpose and intent rather than generic or ambiguous terms. Prefer specific, descriptive terminology that makes code self-documenting and reduces cognitive load for readers.

Key principles:

• Use precise terminology: prefer “excerpt” or “snippet” over “extract”, “find” over “get” for search operations
• Choose descriptive parameter names: file_reader is more precise than content_reader when the function reads entire files
• Import modules for semantic clarity: charset_normalizer.from_path is more meaningful than a bare from_path import
• Use specific types with semantic meaning: IntEnum with named values instead of raw int for severity levels

Example improvements:

# Less clear
from charset_normalizer import from_path
def get_extracts(content_reader: Callable[[str], str]):
    severity: int = 1

# More semantically meaningful  
import charset_normalizer
def find_code_snippets(file_reader: Callable[[str], str]):
    severity: DiagnosticSeverity = DiagnosticSeverity.ERROR
    result = charset_normalizer.from_path(path)

This approach makes code more maintainable by reducing ambiguity and making the developer’s intent explicit through careful name selection.