wiki/src/contribute/working_together/document_progress.mdwn

   1 [[!meta title="Document progress"]]
   2
   3 # Create and update ticket
   4
   5 When a developer works on a task, she should create/update a ticket related to
   6 the task. All the knowledge useful to the others should be kept there (or at
   7 least linked from there). She should take care of updating this ticket's
   8 properties so that they reflect the actual status of the task, and especially the
   9 next thing to do for it to be solved.
  10
  11 The tickets are stored in [[!tails_redmine "" desc="Redmine"]].
  12
  13 When committing changes that will resolve a ticket once merged, please
  14 consider including `will-fix: #NNNN` in the commit message, _NNNN_
  15 being the ticket number. Then, Redmine will automatically flag the
  16 corresponding ticket as "In Progress" once the branch is pushed to our
  17 main [[Git repository|contribute/Git]]. For example:
  18
  19     Remove tails@boum.org duty from frontdesk (Will-fix: #8420)
  20
  21 This keyword should be used only in topic branches, or when committing
  22 directly in the master branch. When merging topic branches into
  23 development branches, you should used the [[`fix-committed`|merge_policy#fix-committed]] keyword
  24 instead.
  25
  26 # Report progress or failure
  27
  28 It is important for the team to know whether somebody is feeling responsible to
  29 make a task happen, or that it's a wishlist/patches-welcome/don't-care-that-much
  30 (would be great, but *We* don't feel committed to make it happen any time soon).
  31
  32 Thus, it is great to state if you'd like to do it, but also to state if you
  33 won't do it anymore. Don't feel guilty: it's better if we all know it won't happen
  34 soon rather than you feel presured while having other priorities!
  35