Comments (17)
I made a brief start at https://docs.google.com/spreadsheets/d/11nqV2j8qc_O5SVsvkZ2JGZP98CABLQ6EwBxAQQi7Huc/edit?usp=drivesdk
Feel free to extend it with other clients.
Also, I'm not sure how to deal with the add-ons for the original CLI. Perhaps a comment referring to the add-on would do.
from todo.txt.
I don't think we should enforce certain tags in the standard, but rather as a recommendation / common practice. Some tools share the same semantics, but that's about it.
Perhaps we could maintain a table of known todo.txt tools (perhaps a public Google sheet) with the tags that they use (syntax, semantics, and whether the tag name for that semantic is configurable).
from todo.txt.
I'm quite surprise there is no "complete" (or completeness) status of a task in percent or in number of items to complete. It could be comp:17% and comp:5/7
It would be useful to quickly see if a task is near completion or not (like writing a book, painting a wall...)
If it was an official recommendation, some tools could implement it with a status bar for example.
Here is a basic exemple with a html rendering which parses a todo file:
from todo.txt.
One that seems to be the most obvious missing to me is a dependency tag. I would think dependency and due date tags should even be considered officially supported per the format definition as those are pretty much universally supported in just about every task management tool ever built...
from todo.txt.
@heX16 there is no full list since each person can use their own set of special tags.
The ones I've seen used across tools have been
due:YYYY-MM-DD
to represent the due datet:YYYY-MM-DD
to represent the threshold date
Maybe it's time we set a few that are part of the standards, such as due
and t
.
Thoughts @todotxt/core
from todo.txt.
What's threshold date?
Anecdotally, and historically, due date has by far been the most-requested addition to the standard. I've pushed back on it for lots of reasons (I'm sure there are ancient discussion threads about this on the mailing list), but I'm fine with revisiting.
from todo.txt.
What's threshold date?
The t
tag gives a start date to an item (also called a threshold, hence the t). It's another way of filtering.
Example
(B) Call mom about dad's birthday gift due:2017-05-06 t:2017-04-20
While the task is due on May 5, 2017, I don't want to see it on my list (via a tool) until April 20, 2017. Moreover, some tools allow customizing how far ahead you want to see a task. Such as, show me tasks that have thresholds X days in the future.
from todo.txt.
Ah okay, thanks for explaining.
My general view has been: as soon as more dates get involved things get pretty complex pretty fast. To me, todo.txt is a task list, not a reminder tool, or a calendar, so these two dates feel outside of the scope of the spirit of the app. Not to mention what a significant burden it would put on client developers to accommodate a not-small amount of date math and other complexity (like hiding tasks that aren't complete but haven't hit their threshold date yet -- that would confuse me if I opened the file in a text editor, and the point of the format is to offer a human-readable text file that can easily be manipulated in any editor).
Anyway, as always, open to dissenting opinions, but if we go back to guiding principles, I think something like threshold date is too much. There's probably a case to be made for due date, though.
from todo.txt.
I don't think we should enforce certain tags in the standard, but rather as a recommendation / common practice.
Oh, I think this is a good idea. Documenting the additional tags various clients have landed on as guidance for the community would be great.
from todo.txt.
I second this. If you look at the original task, @heX16 just wants a list of what's possible.
Moreover, it would really help get the tool developers in sync.
from todo.txt.
This is a great idea. I added the issue
prefix to @bram85 's spreadsheet. Maybe get this moved to Github, though?
from todo.txt.
So seems the most used tages are threshold, recurring, & hide.
most obvious missing to me is a dependency tag
I was thinking of using 'less than' & 'greater than' symbols:
>
depending on / waiting for
from todo.txt.
@farvardin Just to throw an alternative approach out there: All chapters for a book is a rather big task, so maybe it could be a subproject instead, consisting of tasks like "Write chapter 1" etc. (and further broken down, if you so desire). Then it should be relatively straightforward to ask the software what percentage of chapters are done, instead of you having to calculate it manually. In fact, I think that's exactly what the birdseye extension does for you...
from todo.txt.
Android SimpleTask, from https://github.com/mpcjanssen/simpletask-android/blob/master/app/src/main/assets/index.en.md#extensions (as of 2022-09-11):
Simpletask supports the following todo.txt extensions:
- Due date as
due:YYYY-MM-DD
- Start/threshold date as
t:YYYY-MM-DD
- Recurrence with
rec:\+?[0-9]+[dwmyb]
as described here but with a twist.- By default Simpletask will use the date of completion for recurring as described in the link. However if the rec includes a plus (e.g.
rec:+2w
), the date is determined from the original due or threshold date.. rec:1b
will recur after 1 weekday (mnemonic business-day).- The format is described by a regular expression, so in words the syntax is
rec:
followed by an optional+
then 1 or more numbers and then followed by one ofd
ay,w
eek,m
onth ory
ear. For examplerec:12d
sets up a 12 day recurring task.
- By default Simpletask will use the date of completion for recurring as described in the link. However if the rec includes a plus (e.g.
- Hidden tasks with the specified tag
h:1
, this allows dummy tasks with predefined lists and tags so that lists and tags will be available even if the last task with the tag/list is removed fromtodo.txt
. These tasks will not be shown by default. You can temporarily display them from the Settings.
Simple task also has option uuid
from todo.txt.
Seen ttps://gitter.im/todotxt/Lobby?at=6284470aeaf3267f8566d9e3:
id:
blocks:1
I've also seen p:1
to show the parent (for sub-tasks).
from todo.txt.
Just realized spec has another one listed https://github.com/todotxt/todo.txt#rule-2-the-date-of-completion-appears-directly-after-the-x-separated-by-a-space as part of priority for completed tasks:
pri:A
from todo.txt.
wait:
https://lwn.net/Articles/824608/
Hide until wait date, essentially an expected start date
from todo.txt.
Related Issues (20)
- Move tasks to done file is missing HOT 3
- Discussions now open HOT 3
- Completion date: after `x` or after priority? HOT 3
- description.png very hard to read with github official darkmode enabled HOT 1
- Feature request: Option to change sorting order from priority to due date HOT 1
- example in README.md may not follow the format
- description.svg is not showing correctly HOT 2
- making repositioning of context tag and project tag optional HOT 2
- Priority B default color is not bold
- Specify recurrence as n-th day of week/month/year HOT 1
- Can key-value pairs appear anywhere in the line? HOT 2
- Ambiguity in the current todo.txt "spec" HOT 9
- Set priority to C fails HOT 2
- Project and Context case sensitive
- SVG mis-aligned under Mobile Firefox
- key-value pairs starting with numerics HOT 4
- Add more maintainers HOT 18
- Key value pairs meta data clarification HOT 1
- Import simple markdown checklists
- Row text truncated after being marked as completed
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from todo.txt.