Все статьи | Блог студента

Как написать хороший README для вашего проекта на GitHub

Статья написана студентом Хекслета. Мнение автора может не совпадать с позицией редакции
Как написать хороший  README для вашего проекта на GitHub главное изображение

Если вы читаете эту статью, это, вероятно, означает, что вы уже размещаете репозитории на GitHub и, возможно, даже вносите свой вклад в открытый исходный код. А если вы используете GitHub, то вам нужно писать хорошую документацию для своих проектов, чтобы помочь другим понять их.

Когда я впервые зашла на Github, честно говоря, я понятия не имела, что такое файл README (хотя я видела его в проектах других людей).

Во-первых, зачем мне хороший файл README?

Файл README — это руководство, которое дает пользователям подробное описание проекта, который вы разместили в своем репозитории.

Возможно, вам интересно, зачем тратить время на написание хорошего README. Вот несколько причин, которые помогут убедить вас в том, что это хорошая идея:

  1. Хороший README поможет вашим проектам выделиться среди множества других проектов. Он должен быть не хуже самого проекта.
  2. Это первый файл, который увидит человек, столкнувшись с вашим проектом, поэтому он должен быть достаточно кратким, но подробным.
  3. Это поможет вам сосредоточиться на том, что и как нужно реализовать в вашем проекте.

README должен ответить на следующие вопросы: что, почему и как:

  • Что было вашей мотивацией?
  • Какую проблему это решает?
  • Что вы узнали?
  • Что отличает ваш проект от других?

Если в вашем проекте много функций, подумайте о том, чтобы добавить раздел «Возможности» и перечислить их здесь.

enter image description here

Как написать хороший файл README

Вот шаги, которые вы должны предпринять, чтобы написать README.

Включите название вашего проекта

Это название проекта. Он описывает весь проект одним предложением и помогает людям понять, какова основная цель и цель проекта.

Напишите описание

Ваше описание — чрезвычайно важный аспект проекта. Хорошо составленное описание позволяет продемонстрировать свою работу другим разработчикам, а также потенциальным работодателям.

Как установить ваш проект

Если ваш проект представляет собой программное обеспечение или приложение, которое требует установки, вы должны включить шаги, необходимые для установки вашего проекта. Предоставьте пошаговое описание того, как запустить среду разработки.

Как использовать ваш проект

Предоставьте инструкции и примеры, чтобы пользователи/участники могли использовать проект. Это упростит им задачу в случае, если они столкнутся с проблемой — у них всегда будет место для ссылки. Вы также можете вставить скриншоты, чтобы показать примеры работающего проекта.

Если вы работали над проектом как команда или организация, перечислите своих соавторов / членов команды. Вы также должны включить ссылки на их профили GitHub.

Аватар пользователя Ася Степанова
Ася Степанова 16 августа 2021
Рекомендуемые программы

С нуля до разработчика. Возвращаем деньги, если не удалось найти работу.

Иконка программы Фронтенд-разработчик
Профессия
Разработка фронтенд-компонентов веб-приложений
18 мая 10 месяцев
Иконка программы Python-разработчик
Профессия
Разработка веб-приложений на Django
18 мая 10 месяцев
Иконка программы PHP-разработчик
Профессия
Разработка веб-приложений на Laravel
18 мая 10 месяцев
Иконка программы Node.js-разработчик
Профессия
Разработка бэкенд-компонентов веб-приложений
18 мая 10 месяцев
Иконка программы Fullstack-разработчик
Профессия
Новый
Разработка фронтенд и бэкенд компонентов веб-приложений
18 мая 16 месяцев
Иконка программы Верстальщик
Профессия
Вёрстка с использованием последних стандартов CSS
в любое время 5 месяцев
Иконка программы Java-разработчик
Профессия
Разработка приложений на языке Java
18 мая 10 месяцев
Иконка программы Разработчик на Ruby on Rails
Профессия
Создает веб-приложения со скоростью света
18 мая 5 месяцев