Rel4tion-Wiki/todo.mdwn

In the [[ticket|tickets]] tracker, each page is a ticket. Sometimes you just
want to insert a short TODO into an existing page. This is the purpose of the
TODO tracker: collect those TODOs and organize them here.

- [[open]]
- [[closed]]

Due to the use of links to collect items, make sure you link to this page when
referring to the TODO tracker, and not to the subpages - otherwise the page you
linked from will be counted as a TODO item.

To create a TODO item, just make a link to the [[open]] subpage of this page.
For example:

	\[[TODO|TODO/OPEN]] __Read the vegan recipe list and mark the interesting ones__

When it's done, change the link to [[closed]]:

	\[[DONE|TODO/CLOSED]] __Read the vegan recipe list and mark the interesting ones__
	                      (done, now just start trying them when hungry)

To make these links more consistent in style and visible, there is a template
you can use instead. It can add color, size, etc. which are defined in a central
place (the template's page) and make it easy to change the style.

Open item:

	\[[!template id=todo
	             text="Read the vegan recipe list and mark the interesting ones"]]

Closed item:

	\[[!template id=todo
	             done=yes
	             text="Read the vegan recipe list and mark the interesting ones"
	             more="(done, now just start trying them when hungry)"]]

Here are some statistics. Note that pages can contain both open and closed
TODOs, and are then counted for both (but just once in the total), but a page
that contains several open TODOs still counts as a single open TODO. And the
same for closed TODOs. Therefore, read the following as "pages with open TODOs"
and "pages with closed TODOs".

- Open:   [[!pagecount pages="link(todo/open) and !todo"]]
- Closed: [[!pagecount pages="link(todo/closed) and !todo"]]
- Total:  [[!pagecount pages="(link(todo/open) or link(todo/closed)) and !todo"]]