Task Description

A task description is a text string that may have a +project and/or a @taskname.

Project

The first string of non-whitespace characters beginning with a ‘+’ is treated as the project for this entry. The project is useful for grouping tasks and is relevant when using the reporting commands.

The obvious use for projects would be actual business projects. Any way of grouping tasks that works for you is useful.

Note

For example, I also use something like +Admin for daily administrivia, so that it’s easy group that kind of work in reports. Sometimes, I have used a project that is the company name, for company-specific administrative information for the company.

Task Name

Additionally, the first string of non-whitespace characters beginning with a ‘@’ is treated as a task name. Task names are often general task types. For a developer, possibles might include: @Code, @Test, @Docs, @CodeReview, @Deploy, etc.

Obviously, the task names are also very personal. So, use whatever works best for you. I also find myself using special purpose task names, that might never (or rarely) be used again.

Task Details

If a task has no name, the non-project part of the entry is treated as the task name. Otherwise, the non-project, non-taskname part of the event is treated as detail information for the event.