3717 читали · 2 года назад
Как написать впечатляющий Readme-файл для проекта
Источник: Nuances of Programming Readme  —  это детальное описание проекта. В нем содержится информация о том, что представляет собой проект, кто его авторы, как он устанавливается или настраивается, как используется и прочие данные. Readme  —  визитная карточка проекта. Всякий раз, когда кто-то заходит в репозиторий, он первым делом просматривает readme-файлы, чтобы получить представление о проектах. Детальный readme создает хорошее первое впечатление о проекте. Хотите узнать, как создать впечатляющий...
06:44
1,0×
00:00/06:44
27,7 тыс смотрели · 3 года назад
399 читали · 4 года назад
Как написать хороший README: краткий курс
Источник: Nuances of Programming Я решил подробнее изучить проекты с большим количеством правок. У этих проектов есть кое-что общее: отличный readme.md-файл. Сомневаюсь, что можно внести так много правок без хорошего readme. Между качеством readme и количеством правок определенно есть связь! Обратим внимание на несколько известных проектов: React, Vue, freeCodeCamp, Sourcerer и Serverless. В каждом из этих проектов readme.md-файл идеально сочетает в себе документацию, общие сведения о проекте, часто задаваемые вопросы и инструкцию по внесению правок...