Этап
Готова
Тип
Задача
Приоритет
Обычный
Трудоемкость
Обычная
Создана
Дата создания
год и 10 месяцев назад
Назначена
Обновлена
год и 4 месяца назад

У нас несколько changelog:

И мы несколько путаемся где насколько подробно писать.

Кроме того, мажорные релизы добавляют еще правила перехода с релиза на релиз (какие файлы конфигов добавить, какие переменные нужны). Их писать в changelog тоже не очень верно, так как раздувает и путает его.
Тут думаю надо в диреткорию doc добавить release_notes или upgrade, и там отдельные страницы перехода с релиза на релиз.

Панель управления

Комментарии могут оставлять только авторизованные пользователи
 demius год и 4 месяца назад

Как удачно, что забыл закрыть. Тут мы поломали сборку контецнеров переименованием корневой директории. (правда кажется починили вне задачи.

 demius год и 4 месяца назад

Заодно и документацию структуировали, надо бы сделать, чтобы её можно было выводить, про это даже есть задача tndt-81

 demius год и 4 месяца назад

Ну, в целом дублироваие в системах совсем не плохо, просто внутри систем надо разобраться. В проекте

  • директорию help переименовываем в doc, делаем в ней индекс с содержанием.
  • делаем папку history, в которой будет файл history.md c подробным описанием что сделано. и ссылкой на правила обновления
  • В Changlog будет
    • краткое описание всех релизов
    • подробное описания только релиов последней мажорной версии.
  • рядом с индексом install, со ссылкой на history В gitea описание релиза копируемые из history В треккере документ План работы над системой разделить на два.
  • постояно изменяемый план работы.
  • history со всеми прошедшими релизами
 demius год и 8 месяцев назад

Собственно директорию release_notes мы добавили как help/install. Там инструкция по первичной инсталляции, и докуенты по обновлению с версии на версию