diff --git a/source/development/index.rst b/source/development/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..e1e5277c14a670c45f23b5cab08662d02cac2360 --- /dev/null +++ b/source/development/index.rst @@ -0,0 +1,9 @@ +Development Worflows +==================== + +We follow a specific workflow to label our tickets during their life cycle + +.. toctree:: + :maxdepth: 2 + + workflow-tickets.rst diff --git a/source/development/workflow-tickets.rst b/source/development/workflow-tickets.rst new file mode 100644 index 0000000000000000000000000000000000000000..a2569e4b54bf913e638e8f8376497682c045d739 --- /dev/null +++ b/source/development/workflow-tickets.rst @@ -0,0 +1,97 @@ +New ticket opened +================= + +First the label of the dolibarr project should be added to it. +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The dolibarr label are made like this : **PJYYYY**-project number + +We have some basic project number that should always be used by default if there is no customer project. + +- FusionDirectory / Automated Testing / FusionDirectory demo : + **PJ1802-0188** + +- Argonaut : **PJ1802-0190** + +- Packaging Debian / Redhat / Centos / Ubuntu : **PJ1802-0189** + +- Gitlab-ci changes : **PJ1802-0188** + +- User-manual : **PJ2003-0342** + +- Dev Manual : **PJ2003-0343** + +Second the component where the bug/enhancement is to be made should be specified +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Example : fusiondirectory-core or plugin-xxx + +.. warning:: + + It could be several component + +Third if this is a customer under contract the level of support should be added also +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- Example : basic, intermediate, expert, premium + +Ticket as been treated +====================== + +you need to input you time into the ticket with **/spend** with a choice of xxmin, xxhours, xxdays + +.. warning:: + + Very important as it allow to caculate the time spend on this feature or fix + +if some code has been commited and need to be tested +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- The **to be tested** label should be added + +if some more info is needed to act on the report +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- The **need info** label should be added, don’t hesitate to ping the + user reporting the bug with **@(useranme)** to ask him to check it out + +If the change need to be cherry-picked in a -fixes version +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- The **fixes** label is added, when the cherry-pick as been merged we + remove the **fixes** and add the **fixes-merged** label + +if the change need a change in packaging +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +- The **packaging** label is added and a corresponding ticket is open + in the corresponding distribution projects + + - `Debian Packaging`_ + - `Centos Packaging`_ + - `Ubuntu Packaging`_ + + +- The packaging ticket are linked back with the code fix ticket + +The bug is closed +----------------- + +- Remove the **to be tested** label, and add one of the changelog label + to specify what has been done. + + - Added + - Changed + - Deprecated + - Fixed + - Removed + - Security + +Those label are used to generate a changelog when we release a new +version of the software, and also used when we want to search in which +version something has been changed and what the type of change it was + + +.. _Debian Packaging : https://gitlab.fusiondirectory.org/debian +.. _Centos Packaging : https://gitlab.fusiondirectory.org/centos +.. _Ubuntu Packaging : https://gitlab.fusiondirectory.org/ubuntu diff --git a/source/index.rst b/source/index.rst index 0f141bc2063c17145cdc09f3d8d807d06fba633e..81a93ff1aae82a279f047ea39b203278fc06684e 100644 --- a/source/index.rst +++ b/source/index.rst @@ -17,6 +17,7 @@ Contents: :maxdepth: 2 fusiondirectory/index.rst + development/index.rst marketplace/index.rst releasing/index.rst support/index.rst