Items

Overview

Each item is a (possibly repeating) task that you can complete.

To manage items, go to the Items tab. Other tabs also provide convenient ways to add new items or to modify existing items.

The Items tab shows all your items. By default, only active (incomplete) items are shown. You can click on the respective buttons on the top right to show all items or only completed items.

Click New Item to add an item. The basic attributes are:

• The name of the item.
• The cost of the item, which is the number of sessions (see Quota) needed to complete the item. If the cost field is left blank, it will be treated as 0, and VIR will no longer plan sessions for this item on the calendar; however, the item may still be seen and completed from the items tab.
• The parent of the item. See Child items for more details.
• The defer date and/or due date of the item. See Defer date and due date for more details.

In the items list, you can click on the checkbox to the left of each item to mark it as completed.

Child items

Each item can belong to zero or one parent item. A top-level item is an item that doesn't have a parent.

In the Items tab, you can click on the "Add" icon to the right of each item to add a child item. You can also set the parent of a new item directly in the editor dialog.

The effects of parent-child relationships are:

• When you mark a parent item as completed, each child item is also marked as completed. Note that marking all child items as completed will not automatically mark the parent item as completed.
• If an item has child items, the parent item's cost will be entirely determined by the sum of the child items costs, and the user-entered cost value for the parent item is ignored.
• Whenever you fuzzy-search for child items, you can try to search for the "full-path". For example, if you have an item named "Laundry" under the parent item "Chore", you can use the query "chorelaundry" to fuzzy-search for the child item. This helps with disambiguation as well.
• See Defer date and due date for more details about how defer/due dates work with child items.
• See Item repetition for more details about how repetition works with child items.

Defer date and due date

TODO

TODO how the defer date and due date work with parent/child relationships

Item repetition