Источник: Nuances of Programming Readme — это детальное описание проекта. В нем содержится информация о том, что представляет собой проект, кто его авторы, как он устанавливается или настраивается, как используется и прочие данные. Readme — визитная карточка проекта. Всякий раз, когда кто-то заходит в репозиторий, он первым делом просматривает readme-файлы, чтобы получить представление о проектах. Детальный readme создает хорошее первое впечатление о проекте. Хотите узнать, как создать впечатляющий...
Источник: Nuances of Programming Я решил подробнее изучить проекты с большим количеством правок. У этих проектов есть кое-что общее: отличный readme.md-файл. Сомневаюсь, что можно внести так много правок без хорошего readme. Между качеством readme и количеством правок определенно есть связь! Обратим внимание на несколько известных проектов: React, Vue, freeCodeCamp, Sourcerer и Serverless. В каждом из этих проектов readme.md-файл идеально сочетает в себе документацию, общие сведения о проекте, часто задаваемые вопросы и инструкцию по внесению правок...