Pull to refresh
8K+
5
Владимир@voonterr

User

11
Rating
Send message

README врёт: как я сделал open‑source линтер, который сверяет документацию с реальным репозиторием

Level of difficultyMedium
Reading time4 min
Reach and readers8.2K

README редко ломается в один момент.

Обычно он просто постепенно перестаёт соответствовать проекту: переименовали команду, перенесли файл, удалили .env.example, сменили package manager — а инструкция осталась прежней.

В итоге новый пользователь копирует команду из README и получает ошибку. Разработчик же часто узнаёт об устаревшей документации только после issue, сообщения коллеги или неудачного деплоя.

Мне стало интересно: можно ли автоматически находить хотя бы часть таких расхождений, не выполняя команды из README и не отправляя исходный код в LLM?

Так появился RealityLint — open‑source CLI, который статически сверяет проверяемые утверждения из README с реальным состоянием репозитория.

Читать далее

Information

Rating
753-rd
Registered
Activity

Specialization

Бэкенд разработчик
Младший
Python
Git
Linux
Docker
GitHub Actions
CI/CD
Тестирование ПО
Автоматизация процессов