How "Related issues" works exactly?

Added by Maxim Krušina over 9 years ago

What is exact meaning of all four states (related to/duplicates/blocks/preceeds)?
Is it only textual info or is there any advanced linkage?
How is the difference between blocks/blecked by and preceeds/follows?
Is there any automatic notification for owners of blocked issues, when blocking issue was closed?

IMHO it can bee good idea to create small section in Wiki describing all these relations, because it's hard to explore just by trying

PS: also this info is needed for seemless translation, because all temrs must be 100% accurate and descriptive (I just changes a few strings in CZ ;)


Replies (5)

RE: How "Related issues" works exactly? - Added by Eric Davis over 9 years ago

I'm using #100 as the one you set the relationship on and #101 as the "related to"

  • Related - Just adds a link to the other issue
  • Duplicates - Links issues so that changing the status of one, will change the other (e.g. closing #100 will close #101)
  • Blocks - Defines an "order". I think it might affect the Gnatt chart but I don't know.
  • Precedes - Defines an "order", where issue #100 needs to be completed x days before y can be started on.

I only use Related and Duplicates. Related is great for linking similar issues.

I've added this documentation to the FAQ.


RE: How "Related issues" works exactly? - Added by Nikolay Solakov over 9 years ago

Maybe Jean-Philippe has to explain this, because I remember there was an incomplete implementation of this feature in r506.


  • relates to: do nothing special. Just to know that the 2 issues are related...
  • duplicates: will close the related issue with the same status when closing the issue (not implemented yet)
  • blocks: will require to close the blocking issue before closing the blocked issue (not implemented yet)
  • precedes (end to start relation): start date of the related issue depends on the due date of the preceding issue (implemented). A delay can be set so that the related issue can only start n days after the end of the preceding issue. When setting dates for an issue, dates of all downstream issues are set according to these relations.

And what is this in the Wiki page, Eric: "Blocks - Defines an "order". I think it might affect the Gnatt chart but I don't know." !?
This FAQ page is supposed to give answers, not guessings.


RE: How "Related issues" works exactly? - Added by Maxim Krušina over 9 years ago

IMHO, implementation of duplicates should be something like this:
Let's say we have ticket A (master) and users created also tickets B C D - (let!s call them slaves).
So B C and D are set as duplicates to A.
For me as project manager, when I found duplicates I would like to close duplicases and keep just one master ticket A.
So first I would like to set B C D as master and then close them (mabe I copy and paste some usefull additional info into mastter ticket).
But when closing is done automaticaly to all linked (blocked) issues, the all issues will be closed, even when I would like to close slave only...
I thing that closing master should also close slaves, but closing of slave should left other issues intact.

RE: RE: How "Related issues" works exactly? - Added by Daniel Stine over 9 years ago

I agree with Maxim on this one. The automatic closing of duplicates left me unexpectedly with no open issues tracking my overly reported problem. In other words, even though the behavior of duplicates is clearly explained above, that implementation is counter intuitive to the casual user.

I think it also causes a subtle record updating bug as described in my other post.

Best regards,

RE: RE: RE: How "Related issues" works exactly? - Added by Thomas Lecavelier over 9 years ago

So, open a feature request, pointing to this thread.