diff --git a/srcx/doc/changes.adoc b/srcx/doc/changes.adoc index aedc0d63ee5d31f0caee5aeb7526dfca32aa841c..70ec84d3639c88d2e825d5cd876cc1297f4ae6d5 100644 --- a/srcx/doc/changes.adoc +++ b/srcx/doc/changes.adoc @@ -9,6 +9,7 @@ == Лог изменений [square] +* <> Долгоживущие GIT ветки. * <> Множество дополнений в описании проекта для разработчиков: архитектура, workflow, стек технологий. * <> Уточнены настройки MySQL при установке. * <> Создание тестовой БД для разработчиков. diff --git a/srcx/doc/project.adoc b/srcx/doc/project.adoc index 5b92fde62ccb53bcf4a0020d20472648094e3b9c..4f27ed7d69ca39915485c046c13bca984f5df3a8 100644 --- a/srcx/doc/project.adoc +++ b/srcx/doc/project.adoc @@ -221,14 +221,14 @@ BGERP запускается в IDE, с подключением к удалён |Изменение программы и документации. |<> -|*documentation* +|*p11862-documentation* |master -|Корректировки документации. Долгоживущая ветка, периодически переносится на master. +|Корректировки документации. <>, периодически переносится на master. |<> |*documentation-change-request* -|documentation -|Предложения по корректировке документации, могут быть смерджены обратно на documentation. +|p11862-documentation +|Предложения по корректировке документации, могут быть смерджены обратно на p11862-documentation. |<> |=== @@ -290,16 +290,7 @@ git remote prune origin git fetch origin master:master ---- -[[documentation]] -=== Документация -Исходные файлы в формате AsciiDoctor размещаются в каталоге *srcx/doc* проекта. -Модификация исходных кодов программы и документации выполняется одновременно в ветке <>. -Примеры форматирования и рекомендации можно посмотреть <>. -Документация может быть <> локально с ветки и <> в пакет обновления. - -Публикация документации <> с ветки <> *documentation*. -Для предложения больших правок следует создать префиксом *documentation-*, начинающуюся с данной. - +[[accept]] === Приёмка и перенос При принятии изменения производится сравнение ветки с основной. Поэтому перед передачей изменения необходимо смерджить на ветку актуальное состояние основной. @@ -326,6 +317,23 @@ git push Периодически с основной ветки <>. +[[longlife-branch]] +=== Долгоживущие ветки +В долгоживущих ветках производятся изменения *не влияющие на функциональность продукта*. +Как-то: корректировка локализации, документации, форматирование кода, тесты. +Процесс изменения при этом не закрывается, а <> производится многократно по мере готовности очередной порции изменений. + +[[documentation]] +==== Документация +Частным случаем долгоживущей ветки является документация. +Исходные файлы в формате AsciiDoctor размещаются в каталоге *srcx/doc* проекта. +Модификация исходных кодов программы и документации выполняется одновременно в ветке <>. +Примеры форматирования и рекомендации можно посмотреть <>. +Документация может быть <> локально с ветки и <> в пакет обновления. + +Публикация документации <> с ветки <> *p11862-documentation*. +Для предложения правок документации следует создать ветку, начинающуюся с данной. + == Архитектура BGERP представляет из себя standalone Java приложение с динамическим Web интерфейсом. Запуск во время разработки может быть <> прямо в IDE.