Docstring, который читают люди и машины: 14 промтов, превращающих Python-код в самодокументируемый

Вы когда-нибудь возвращались к своему коду через полгода и чувствовали себя археологом, раскапывающим древние руины? Комментарии в стиле «здесь магия» и docstring, который просто повторяет имя функции, — знакомая боль. Хорошая документация — это не роскошь, а необходимость: по данным исследования Google, разработчики тратят до 50% времени на чтение и понимание кода. А теперь представьте, что AI может взять на себя рутину написания docstring и технических описаний, а вы сосредоточитесь на архитектуре и логике. В этой подборке — 14 проверенных промтов, которые превратят ваш Python-проект в образец самодокументируемости. От простых docstring до полных README и диаграмм — все готово к копипасту.