Ruff first-word-uncapitalized (D403)

first-word-uncapitalized в Ruff проверяет код на предупреждение D403. Правило относится к группе pydocstyle.

Почему это неправильно

Docstring помогает понять публичный интерфейс и должна быть оформлена так, чтобы её корректно читали люди и инструменты.

Если валидатор показывает это предупреждение, исправьте место, на которое указывает Ruff, ориентируясь на смысл правила first-word-uncapitalized и пример ниже.

Пример ошибки

def average(values: list[float]) -> float:
    """return the mean of the given values."""

Как правильно

def average(values: list[float]) -> float:
    """Return the mean of the given values."""

Автоисправление

Ruff всегда может предложить автоисправление для этого правила.