skyleecm, 12 Aug 2016

onestodo.com domain is expiring soon

The domain will not be renewed.

The site can still be accessed by ones-todo.appspot.com

 

Comments Tags: domain, OnesTodo, gae

skyleecm, 26 Feb 2010

Doing tasks with OnesTodo

Completing tasks

  • If you have completed a task, you can click on the no link next to the task title in the Todo List page to mark it as completed.
  • If the completed task is only a sub-task in a project, you can ensure that the next step for the project and a scheduled date is created. You can either just modify the todo title to show the next step and change its due date, or you can create a new sub-task for the next step for the project.
  • To create the next step as a new sub-task, you can click on the project task link in the Todo List page to edit the task.
  • In the Edit Todo page, click on the Add new subtodo link to create a new sub-task. This will reuse the values in the project task for the new sub-task except for the description which is blank out.
  • Change the title to show a brief description of the task, what to do next. You can use something like "Next step - project title" to know that it is part of the project.
  • Modify the other fields and enter all relevant information about this task in the description, and then save the task.
  • Note: if you mark a project task as completed, all of the sub-tasks will be mark as completed as well.
  • You can delete a completed task instead of marking it as completed.
 

Comments Tags: todo, documentation, faq, user-guide, gtd

skyleecm, 26 Feb 2010

Reviewing tasks with OnesTodo

Daily Review of tasks

  • In the Todo List page (main page), select Today Favourites List to browse all your pending/uncompleted tasks that you have scheduled for today or before today.
  • If you have completed a task, you can click on the no link next to the task title to mark it as completed.
  • If you need to reschedule a task, click on the task link to edit it and then change its due date. After saving the task, click on the Last search link to return back to your search list.
  • You can select "1 Week" Favourites List to browse all your pending/uncompleted tasks that you have scheduled within a week or before today. (This actually search for Due date<=7d and Done=no. You can adjust the due date search value to search for tasks that will be due by tomorrow for example)
  • Note: Todo list is sorted by default using the due date, priority in descending order, follow by title. The other sorting provided, newest, orders the task list by its creation date in descending order.

Monthly Review of tasks

  • If you use/reserve priority=1 for tasks you may someday want to do (as described in Processing tasks). You can create a Maybe favourites list. First, do a search for priority=1 and Done=no and then assign a name, Maybe for the search. Below the Todo List results table, Click on the Edit link beside the Current Search text, enter Maybe as the name and click on the Save button to create the Maybe favourites list.
  • If you decide you want to do a Maybe task, you can edit the task and schedule its due date and change its priority value to any value from 2 to 9. After saving the task, click on the Last search link to return back to your Maybe list.
  • You can also delete any tasks that you no longer care about by selecting the checkbox next to the task and clicking on the Delete button below to delete the tasks.
 

Comments Tags: todo, documentation, faq, user-guide, gtd

skyleecm, 26 Feb 2010

Processing tasks with OnesTodo

A task is processed when you knows what you are going to do next to complete the task, and when you are going to do the task.

Unprocessed to Processed

  • In the Todo List page (main page), select Unprocessed Favourites List to browse all your Unprocessed tasks.
  • Click on the task link to edit it.
  • In the Edit Todo page, change your title to show a brief description of the task, what to do next.
  • Enter a priority. (You can use/reserve priority=1 for tasks you may someday want to do. You can create a Maybe favourites list later by searching for priority=1 and assigning a name, Maybe for the search)
  • Enter the contexts. They divide your tasks so you can find them easily. (General contexts divide tasks within general areas of your life — such as Work, Personal, Home, or School. You can also grouped actions like errands, calls, shopping, etc. You can use a person name to indicate the task has to be done with him/her.)
  • Enter a due date to give a loose schedule when you are going to do the task.
  • You can select an uncompleted task as the project of this task.
  • Enter all relevant information about this task in the description. If this task is a project (A project is a task that cannot be completed in one step), you can enter all the steps that are in your mind into the description.)
  • Enter any tags. (You can use this to further classify your tasks)
  • Click on Save button to save the task.
 

Comments Tags: todo, documentation, faq, user-guide, gtd

skyleecm, 26 Feb 2010

Collecting tasks with OnesTodo

Adding a new Unprocessed task

  • In the Todo List page (main page), click on the Add radio button to switch to the Quick Add mode. It will then display the Add new todo button instead of the Search button.
  • Type in a brief task description in the title.
  • Click on Add new todo button to save the task.
  • The rest of the fields are optional, if no priority is entered, the task is considered as Unprocessed and will appear in the Unprocessed Favourites List.

Email a new Unprocessed task

  • First, you need to enable the Allow using email to create new todo option in the User Preference page. (Click on your email or name link at the topright to go to the User Preference page.)
  • To create a new task, send an email (either a new email or forward an existing email) from your email (the Google login email or your shared OpenID email) to either today@onestodo.com or yyyy-mm-dd@onestodo.com (eg. 2009-12-31@onestodo.com)
  • The due date of the todo is set to the date equivalent to the email name that your email is sent to.
  • The email subject becomes the todo title and the text body or the html body will become the todo description.
  • If you are using Google Gmail, it is also possible to setup filters to auto-forward email.

Using Chat (xmpp) to add a new Unprocessed task (only for paid subscription)

  • First, you need to enable the Allow using chat/xmpp to manage todo option in the User Preference page. (Click on your email or name link at the topright to go to the User Preference page.)
  • Second, you need to enter your xmpp address and you are required to confirm it. You need to use a chat software to accept our invitation from onestodo@appspot.com and then to send back a confirmation chat message to onestodo@appspot.com.
  • Send a chat message to onestodo@appspot.com like /add title:do something task
  • Only title is required for a new task. The rest of the fields are optional, if no priority is entered, the task is considered as Unprocessed and will appear in the Unprocessed Favourites List.
 

Comments Tags: todo, documentation, faq, user-guide, gtd

skyleecm, 26 Feb 2010

OnesTodo Xmpp chat interface

OnesTodo has an alternate xmpp/chat interface for managing tasks or todos using the Xmpp protocol available only for paid subscribers.

In order to use it, you need to enable it in the User Preference page. When you enable your chat/xmpp address, onestodo@appspot.com will send an invitation message and a confirmation message to your address. Please accept onestodo@appspot.com immediately, so that you can receive the confirmation message which will arrive shortly in about 2 minutes time. You need to send back the same confirmation message to onestodo@appspot.com within an hour so as to confirm your xmpp address before you can use Xmpp to manage todos.


The confirmation message looks like

/confirm your xmpp address by sending back this message (b4ea9e29851212c600c97c44e8e8..bd)

You need to send back the same message back to onestodo@appspot.com.

/confirm your xmpp address by sending back this message (b4ea9e29851212c600c97c44e8e8..bd)

If OnesTodo confirm your xmpp address, it will send back the following message to you:

Your xmpp address xxx@yyy.com is confirmed. You can chat with onestodo@appspot.com to 
manage your todo.

Once your xmpp address is confirmed, you can use a chat software that supports Xmpp. You are already using it since you need to send the confirmation message. In Linux, we suggest to use Empathy Instant Messenger. The only requirement is that the software has to support entering multiple lines before sending the chat message. (For Empathy IM, hit Ctrl-Enter for a new line, hit Enter to send the message.)

In general, each message starts with a command word that is preceded by a /

The supported commands for managing todos are:

And the supported commands for searching of todos and managing search are:


To create a new unprocessed todo, you enter a message like,

/add title:write documentation for todos chat interface

The add command creates a new todo. Only the title attribute is required. It accepts the following todo's attributes: priority, context, due-date, project, tags. Each attribute has to start on a new line, after each attribute name, enter : follow by its value. (eg. priority: 5)

The description attribute of a todo supports a multi-line string, and is entered after all the other attributes are entered. A special attribute content-type can be used to specify the markup that is used in the description. The content-type value can be either of the following: text/markdown, text/textile or text/html .

A complete add message looks like:

/add title:test create new task
priority: 5
context: work
due-date: 2010-02-25
tags: testing
This is a testing message
to create a new todo.

..
end of task description.

After sending the above message to onestodo@appspot.com, it will send back a reply that looks like:

Todo (id=1721) is created for test create new task

A Todo is identified by its id, any subsequent action on the above todo requires the id attribute to be entered.


To view the above todo, you enter and send this message:

/view id:1721

You will receive the below message:

Details of Todo (id=1721) follows:
id: 1721
title: test create new task
priority: 5
context: work
due-date: 2010-02-25
project: 
tags: testing
completed-date: 
time-taken:

This is a testing message
to create a new todo.

..
end of task description.

To edit/update the above todo, you are allowed to modify any of its attributes and only enter those modified attributes and their values. For example, to update its priority to 7, enter and send this message:

/edit id:1721
priority: 7

You will receive the below reply:

Todo (id=1721) is updated for test create new task

A project task in OnesTodo is a task with sub-tasks. The project attribute identifies the task's parent task (or project task). For example, you can create a new sub-task of the above todo with this message:

/add title: create a new subtask - test create new task
priority: 5
context: work
project: 1721
tags: testing

You will receive a reply like:

Todo (id=1722) is created for create a new subtask - test create new task

To edit/update the project task (id=1721) so that its description now contains a link to its new sub-task using the markdown markup format, you can enter this:

/edit id:1721
content-type: text/markdown
This is a testing message
to create a new todo.

* [create a new subtask](/1722)

..
end of task description.

In the web interface, this todo's description will contain a hyperlink to its sub-task.


To mark the todo as done/completed, you need to use the edit command with the special attribute done with a value of yes like:

/edit id:1722
done: yes
completed-date: 2010-02-26

The completed-date and time-taken attributes are modified only when a todo is done/completed, so when a todo is marked as done, it requires the done: yes.

To update the above completed todo's time-taken, you can enter this:

/edit id:1722
time-taken: 1 hour

The supported unit of time-taken are those listed in the Edit Todo web page.


To delete the todo, you enter and send this message:

/del id:1722

You will receive the below message:

Todo (id=1722) is deleted for create a new subtask - test create new task

The search command searches for todos that match the entered attributes. (see OnesTodo User interface) It accepts the following todo's attributes: title, priority, context, due-date, project, description, tags and done.

The priority and due-date attributes supports inequality search. You can also use 2 due-date criteria for due-date that falls between 2 dates.

The default Pending Todos search is equivalent to:

/search done:no

To search for the above entered todos using context=work and tags=testing, enter this:

/search context:work
tags:testing

You will receive a reply like:

Number of search results: 1:
page: 1
1. test create new task (p7 !2010-02-25 @work) [id=1721]

The attributes that are displayed are similar to those in the web search interface, except for the done attribute.

(p7 !2010-02-25 @work) is the shorthand notation for priority=7, due-date=2010-02-25, and context=work.

Each page of search results only display up to 10 todos, you can browse for subsequent pages using the page attribute. For example:

/search done:no
page: 2

By default, the results are ordered in default sort order. To sort by the newest order (newer task sorted first), enter the sort attribute like:

/search done:yes
sort: new

The other special search is the favourite search using the name attribute. This is equivalent to the Favourites List dropdown search.

The Unprocessed list search is

/search name:Unprocessed

The Today list search is

/search name:Today

It is also by default equivalent to:

/search due-date: <=today
done: no

When the name attribute is used, the other attributes are ignored, except for the page and sort attributes.


The editsearch command also searches for todos that match the entered attributes, with the additional requirement that the name attribute must be set. The editsearch command assigns the entered name as the favourite search for the entered search criteria, so that you can perform the same search using the name attribute with the search command.

For example, to only list tasks that are due today at work, you can assign "Today Work" as favourite with:

/editsearch name:Today Work
due-date: <=today
context: work
done: no

You will receive a reply like:

Search is assigned as the favorite term: Today Work
Number of search results: 1:
page: 1
1. test create new task (p7 !2010-02-25 @work) [id=1721]

Subsequently, the same search using "Today Work" favorite search is:

/search name:Today Work

The searchfavs command display the list of favourite search.

/searchfavs

You will receive a reply like:

Number of search favorites: 5:
1. 1 Week
2. Maybe
3. Today
4. Today Work
5. Unprocessed

The removefav command removes a favourite search using the required name attribute.

For example, to remove the previously assigned "Today Work":

/removefav name:Today Work

You will receive a reply like:

Favorite search term Today Work is removed.

After this, searching using "Today Work" favorite search will not work, until it is being assigned as a favorite search.

 

Comments Tags: todo, documentation, faq, user-guide, gtd, xmpp

skyleecm, 26 Feb 2010

OnesTodo Edit Todo page

The Edit Todo page allows the user to create a new processed task or sub-task, to edit the task and to delete the task. User can go back to the Todo List page by clicking on any of the links: Pending Todos, or Last search. (see OnesTodo User interface)

Edit Todo form

At the top of the Edit Todo form, there are 3 links (or 2 links):

  • Add new todo
  • Add new subtodo
  • View Todo (or Edit Todo)

If the user is adding a new task (or todo), the Add new subtodo link will not be shown.

Add new todo

Clicking on Add new todo link will clear off the existing form values and allow user to enter and create a new task.

Add new subtodo

This link will only appear if the user is editing an existing todo. Clicking on the Add new subtodo link allows user to create a new sub-task (the sub-task 's project is set to the existing todo). This will reuse the attribute values in the project task for the new sub-task except for the description which is blank out. The new sub-task will also be immediately mark as completed if its' project is already completed.

View Todo (or Edit Todo)

User can click on the View Todo link to view the task being edited. This is useful if the user is using any of the text markup for the task's description. The user can check whether the rendered description is correctly formatted. It is also possible that the user may just want to view the task's details instead of modifying the task. Also, if it is a sub-task, its' project is displayed as a link in the view mode and user can click on it to browse the project task. In view mode, this link is displayed as Edit Todo, clicking on it again will switch the form back to edit mode.


Todo form

Title should reflect what the user is going to do next for the task. Title is required.

Priority is required. Valid values for priority are from 1 to 9 where 9 is considered as the highest priority and 1 is the lowest. (Note: there is no way to create an Unprocessed task here because priority is required here.)

Context values is a list of comma delimited words. They divide your tasks so you can find them easily. (General contexts divide tasks within general areas of your life — such as Work, Personal, Home, or School. You can also grouped actions like errands, calls, shopping, etc. You can use a person name to indicate the task has to be done with him/her.)

Due date is used as the date a task is scheduled to be done. It only accepts the date format in yyyy-mm-dd . User can also click on the date icon to open up the calendar widget to select a date.

Project can be selected here from a list of the user's uncompleted tasks. The task being edited will become a sub-task of the selected project task. When the user uses Add new subtodo, the project is set automatically.

Description allows the user to enter all relevant information and details about the task. Description supports using any of the 3 different text markup formats: html, markdown or textile. The advantage of using either markdown or textile over using html is that they are easier to read, they do not use additional markup tags which will also be indexed. If this task is a project task, the user can enter all the known steps into the description. Since, each created task has a task id (a number), the user can also create a hyperlink to any of his/her existing tasks. This is useful if the user has created a reference item that contains information only (not actually a task), the user can create a link to his/her reference item in the description if the reference information is needed for the completion of this task. For example, if I have a reference task id: 1009, I can create a link to it with [My secret info](/1009) using markdown format.

Tags are similar to Context. Tags values is a list of comma delimited words. They can be used to further categorize your tasks.

Completed date is the task's date of completion. In general, the user does not need to manually enter a date, because the current date will be used by default when the task is marked as completed. In the case when an edited task is not completed yet, the Mark as done link will be displayed instead of the task's completion date. User will have to click the Mark as done link to indicate the task is completed before saving the task.

Time taken allows user to record down an approximate time taken to complete the task. If the task is not completed yet, user will have to click the Mark as done link to indicate the task is completed before being allowed to enter the time taken for the task.

User clicks on the Save button to save the task. If the user has marked the task as completed, all its sub-tasks that are not completed yet will also be marked as completed with the same completion date. If there are any validation error, the task will not be saved and the Todo form will redisplay the task values with the detected errors.

If the form is displaying an existing todo, the user can click on the Delete todo button to delete the task. Note: there is no confirmation prompt for the delete action. If the todo is a project task that has sub-tasks, another button, Delete all todos, will be available. Clicking on the Delete all todos button will delete the task and all its sub-tasks. After a task is being deleted, a "Delete is successful." message will be shown before the browser redirects the user to the user's Last search todos list.


Sub Todos

If the todo is a project task that has sub-tasks, all its sub-tasks will be displayed at the bottom of the page. Each sub-task is displayed with a link of the sub-task's title, and user can click on the link to browse or edit the sub-task. A sub-task of a sub-task is displayed with a slight indentation relative to its parent task.


Comments

User can also post comment to a task. Posted comments of a task will be displayed in this page. Comments cannot be searched though as compared to a task's description.

 

Comments Tags: todo, documentation, faq, user-guide, gtd