Правила заполнения тикетов для лейбла docs - NurOrNuLL/ESDP-AP-5-6-TEAM-2 GitHub Wiki
Правила заполнения тикетов для docs
Конечный результат:
- Конечный результат - что нужно сделать? Здесь задается основная тема новой статьи для дополнения документации, а также вкратце указываются условия которые нужно учесть или варианты выполнения задачи при необходимости.
- Пример Создать краткую статью в вики по Docker с дополнительными ссылками на информацию по разделам
План решения:
- Описаниe создания, дополнения или редактирования статьи документации с упоминанием всех предметов, необходимых для упоминания в документации и относящейся к заданной теме. Также здесь можно указать необходимую дополнительную информацию
- Пример Добавить краткое описание Docker, проблемы, которые он решает и варианты применения.
- Пример Описать подробное руководство по установке Docker для Linux
- Пример Добавить ссылки с руководством по установке Docker для других операционных систем
- Пример Добавить ссылки с наиболее часто встречающимися ошибками при установке
Мотивация:
- Мотивация - для чего необходима статья в документации по данной теме? Здесь описываются причины, по которым нам необходимо иметь описание данной темы, целевая аудитория и задачи, которые могут быть решены помимо основной - информирования.
- Пример Данная статья доказывает принципиальное преимущество применения Docker для нашего проекта разработчикам, приступающих к поддержке или расширению проекта.
Критерии приемки:
- Критерии приёмки - как проверить, что задача выполнена. Здесь указываются пункты, которые читатель должен увидеть в статье, а также ответ на поставленную задачу, которая была обозначена. Если статья добавляется в виде вложенной библиотеки, также можно описать ожидаемую структуру навигации по пунктам статьи.
- Пример: В меню документации в разделе библиотека, при переходе по теме Docker, открывается страница с кратким описанием Docker, его архитектуры и руководством по установке. В конце статьи есть ссылки на документацию Docker.
Планируемое время выполнения:
- Описать примерное планируемое время выполнения данного тикета.
Пример для title:
Создать краткую статью в вики по Docker
Пример для body:
## Конечный результат:
* Создать краткую статью в вики по Docker с дополнительными ссылками на информацию по разделам
## План решения:
* Добавить краткое описание Docker, проблемы, которые он решает и варианты применения.
* Описать подробное руководство по установке Docker для Linux
* Добавить ссылки с руководством по установке Docker для других операционных систем
* Добавить ссылки с наиболее часто встречающимися ошибками при установке
## Мотивация:
* Данная статья доказывает принципиальное преимущество применения Docker для нашего проекта разработчикам, приступающих к поддержке или расширению проекта.
## Критерии приемки:
* В меню документации в разделе библиотека, при переходе по теме Docker, открывается страница с кратким описанием Docker, его архитектуры и руководством по установке. В конце статьи есть ссылки на документацию Docker.
## Планируемое время выполнения:
* 1 час