Как документируешь свои доработки или разработки

class DataProcessor:
    """Обрабатывает данные, применяя указанные фильтры.

    Attributes:
        filters (list): Список применяемых фильтров.
        verbose (bool): Флаг вывода отладочной информации.
    """

def __init__(self, filters=None, verbose=False):
    """Инициализирует процессор данных.

    Args:
        filters (list, optional): Список фильтров. По умолчанию None.
        verbose (bool, optional): Режим отладки. По умолчанию False.
    """
    self.filters = filters or []
    self.verbose = verbose

def process(self, data):
    """Обрабатывает входные данные.

    Args:
        data (pd.DataFrame): Входные данные для обработки.

    Returns:
        pd.DataFrame: Обработанные данные.

    Raises:
        ValueError: Если входные данные пустые.
    """
    if data.empty:
        raise ValueError("Input data cannot be empty")
    # Логика обработки
    return data

Для изменений в существующем коде добавляю комментарии в коммитах, используя Conventional Commits, и обновляю CHANGELOG.md. Для сложных изменений создаю ADR (Architectural Decision Records) в папке docs/adr/.