1. Alex Willmer
  2. trac-ticketlinks

Commits

Alex Willmer  committed e844f63

Instructions

  • Participants
  • Parent commits acaf207
  • Branches default

Comments (0)

Files changed (1)

File Home.wiki

View file
  • Ignore whitespace
-== Welcome ==
+== Trac ticket-links branch ==
 
-Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it.
+This branch of the Trac is based on the ticket-links branch by cboos at http://svn.edgewall.org/hg/trac/topic/ticket-links. It adds the following behaviour to ticket links:
+ - Details of linked tickets are shown when viewing the current ticket
+ - A linked ticket may be created using the current ticket as a template. Configured fields will be pre-populated.
+ - Linked tickets may block closure of the ticket (e.g. a blocks/blockedby, parent/children relationship). This is configurable.
+ - Any ticket may be used as a template for new tickets, without the created tickets being linked.
 
-=== Wiki features ===
+=== Example ===
 
-This wiki uses the [[http://www.wikicreole.org/|Creole]] syntax, and is fully compatible with the 1.0 specification.
-
-The wiki itself is actually a hg repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. It will be live immediately.
-
-Go ahead and try:
+To configure ticket-links for a relationship in which
+ - Any ticket may depend on and be dependant on many tickets
+ - A ticket may not be closed until all tickets it depends on are closed
 
 {{{
-$ hg clone http://bitbucket.org/moreati/trac-ticketlinks/wiki
+[ticket-links]
+dependency = dependson,dependant
+dependency.validator = no_cycle
+dependant.label = Dependant
+dependson.label = Depends on
+dependson.blocks = true
 }}}
 
-Wiki pages are normal files, with the .wiki extension. You can edit them locally, as well as creating new ones.
-
-=== Syntax highlighting ===
-
-You can also highlight snippets of text, we use the excellent [[http://www.pygments.org/|Pygments]] library.
-
-Here's an example of some Python code:
+To confgiure a relationship in which 
+ - A ticket may have many child tickets, and at most one parent ticket
+ - A new child ticket will have it's summary and description pre-populated from it's parent
+ - A parent ticket may not be closed until all child tickets are closed
 
 {{{
-#!python
-
-def wiki_rocks(text):
-	formatter = lambda t: "funky"+t
-	return formatter(text)
+[ticket-links]
+parentchild = parent,children
+parentchild.validator = parent_child
+children.blocks = true
+children.label = Child
+children.copy_fields = summary, description
+parent.label = Parent
 }}}
 
-You can check out the source of this page to see how that's done, and make sure to bookmark [[http://pygments.org/docs/lexers/|the vast library of Pygment lexers]], we accept the 'short name' or the 'mimetype' of anything in there.
+To configure a relationship in which
+ - A ticket may refer to another ticket, and there is not reciprocal link
+ - A ticket may be closed regardless of the link
 
-Have fun!
+{{{
+[ticket-links]
+reference = refersto
+refersto.label = Refers to
+}}}
+
+Many different relationships may be configured at once, relationship names must each be unique.