When the gadget loads into your waveyou will see a short welcome message and a text bar. Just type a task title and hit Enter to add your first task. Try entering "Walk the dog tomorrow" to see how it works (and please, walk the dog(s)).
The gadget has some common actions ready to use in the user interface, and common shortcut keys function as well (e.g. hit 'C' to complete a selected task, hit 'Delete' to delete tasks...).
You can even use a "geeky syntax" to add useful data to your task such as a Due Date, Priority, Tags, Location, etc, via text shortcuts in the text box. Try '^', '!' or '#'. It will also suggest common auto-complete options to select from (and not only if you're a geek :).
Clicking the task rows (paragraph sign) will open a task details-view pane, so you can edit interesting fields related to the task by clicking the field names, change the due date using a simple visual calendar Date Picker, visit a related web link, or go to a map search of a related location.
We hope it will provide a simple to use sharing experience.
Advanced featuressuch as creating a discussion wave for discussing a task or adding a task to the gadget by selecting text while reading a different wave and pressing a button are automated by a Wave Robot participant which you can add. To utilize it, add todoit-reminder@appspot.com to your contacts, and then invite it to a wave which has a ToDoIt gadget inserted in the first Blip. The robot should greet you and say how to set your default target wave, to which it will add your "Add Text as Task" selections that you make on this or other waves on which the robot is a participant. To select texts for this purpose, you can use a toolbar button which will annotate your currently selected text when you press it. The URL address for installing this toolbar button is separate, for interested users: http://todoit-wave.googlecode.com/svn/trunk/installer-annotate-addastask.xml
The creating a discussion wave for discussing a task feature is accessed using the "Discuss" link in the details-view of a task. Pressing it will create (or join, if one exists) a task discussion wave with simple info on the specific task. A sub-feature of this "task wave" is that changing its title should propagate (via the robot) to the original ToDoIt gadget wave and change the task's title there, appropriately.
-- After editing the task's wave title or using "Add as Task", we have to wait for a new event from the gadget, before the robot can update it. Any event generated by any user is good for this purpose. (The next time someone plays with the gadget, the robot will see and update it). -- This is mandatory because the context to the gadget is lost until the robot sees a new event related to it. --
Please beware as the robot is experimental, may ignore (not be able to see) your requests or even see duplicate requests, may cause the gadget to "jump" or even create a broken copy of it, suffers from missing context API bugs (certain events currently require actions to occur on the gadget before it will be able to "see them", making its response not in "real time"), and general Wave craziness, to boot. It seems to also work better on the Wave Sandbox, so you may currently prefer to invite it there. Unfortunately, this is how it currently is on the Wave for these uses, and Wave Robots suffer from a variety of these and other glitches. These bugs are documented and linked to related discussions in the source code comments. It does work, however, under these limitations.
Please feel free to check out the source code if you are a developer. If you'd like to join the effort, contact us. To report bugs and/or request features, you can use the Google Code issue tracker.
