News for hackers. Stuff that matters.
Re:Show HN: A plain-text file format for todos and check lists by D13Fd on Friday April 01, 2022 @12:21PM (#30879913)
I am conflicted on this.

The spec is nice. I love the recognition that dates may be imprecise (e.g., 2022-05 -- although I would count that as the last day of the period, 23:59:59 on 2022-05-31, rather than the first day of the next period, 2022-06-01). I like the thought that went into it and the nice presentation.

On the other hand, I do not think this is necessary or even all that helpful in the real world. You don't need a standardized format if you are writing to do items manually in a text editor. You just write them. In the vast majority of cases no one is going to see them but you. Time spent conforming to a spec is time wasted.

A formal spec also doesn't help much for apps to use this format. There is not a huge need for portability between to do apps, and for most users to do items are ephemeral and not something that needs to be archived and revisited. Even if an app adopted this, being tied to a plain text format would likely hinder feature development, including the ability to sync across multiple devices. Beyond that, different to do apps use different systems of categorization and tagging, so really in practice I doubt this will become any kind of standardized format.

So, all told, it is a beautiful effort, nicely presented, but I think it is unnecessary.

Re:Show HN: A plain-text file format for todos and check lists by vhanda on Friday April 01, 2022 @12:58PM (#30880458)
> A formal spec also doesn't help much for apps to use this format. There is not a huge need for portability between to do apps, and for most users to do items are ephemeral and not something that needs to be archived and revisited. Even if an app adopted this, being tied to a plain text format would likely hinder feature development, including the ability to sync across multiple devices. Beyond that, different to do apps use different systems of categorization and tagging, so really in practice I doubt this will become any kind of standardized format.

I disagree. I maintain a rather popular plain-text-based app [1] and the formal spec makes this something very very easy to add support for. Infact the only thing that could make this even easier is if there was a way to verify my own implementation.

[1] https://gitjournal.io

Re:Show HN: A plain-text file format for todos and check lists by D13Fd on Friday April 01, 2022 @01:22PM (#30880745)
Yes, you could add support for it. To what end? Do you think the usage will be high enough to justify the effort to implement and maintain it?

Even imagining the ideal world where every to-do app implements this, portability of to-do items between apps just isn't that big of a problem. There isn't a big need to move long lists of to-do items between apps.

And in the real world, this won't be implemented perfectly. You'll have the App A implementation, the App B implementation, and so on. Look at Markdown. You'll have headaches migrating your to-do items automatically and in the end, most likely, you'll just end up copy and pasting them. It's not that hard and old to-do items aren't that important to the vast majority of people.

Re:Show HN: A plain-text file format for todos and check lists by vhanda on Friday April 01, 2022 @02:21PM (#30881569)
This sounds a bit defeatist.

Yes, it won't be perfect at first, but there is always a chance of reducing the barrier to entry. The lower it is, the more % of users / developers / apps are going to use it.

Re:Show HN: A plain-text file format for todos and check lists by D13Fd on Friday April 01, 2022 @08:36PM (#30884792)
It's not defeatist. As I said, I just don't think, even in the optimal scenario, that it is a goal worth achieving. Personally I'd rather software developers focus their time on more worthwhile features.
Re:Show HN: A plain-text file format for todos and check lists by vinodkd on Sunday April 03, 2022 @11:25AM (#30897610)
Not sure I agree. I didnt know about gitjournal until vHanda's post, but immediately saw how it could be a replacement for my use of Google Keep (which I use when I'm on the go vs at my laptop). And there was already an exporter for Google Keep. I'm guessing that exporter benefited from a spec being available.

Your point about "if you're the only one using it, just use it" does apply, but sometimes we do find ourselves being more successful than we originally expected and defining things via a spec is not a bad thing.

Re:Show HN: A plain-text file format for todos and check lists by paulryanrogers on Saturday April 02, 2022 @05:01PM (#30891641)
What is worthwhile can vary widely. Like the quote that people use only a slice of Word, yet often different slices.
Re:Show HN: A plain-text file format for todos and check lists by armchairhacker on Friday April 01, 2022 @01:50PM (#30881117)
yes

To add to this, many markdown apps do support TODOs, but they use their own format. e.g. Bear uses

    - [ ] Unchecked
    - [X] Checked
If there was a widely-accepted standardized markdown format for TODOs you could write them in one app and then they would display properly in others.
Re:Show HN: A plain-text file format for todos and check lists by bobajeff on Friday April 01, 2022 @02:58PM (#30882003)
Foam Notes also uses that same markdown format for checklists. I think that Markdown is a pretty good format for notes and is already used by enough apps.
Re:Show HN: A plain-text file format for todos and check lists by Pxtl on Friday April 01, 2022 @11:36PM (#30885658)
Microsoft Azure DevOps does too.
Re:Show HN: A plain-text file format for todos and check lists by GauntletWizard on Friday April 01, 2022 @04:06PM (#30882724)
I'm a happy gitjournal user, and I want to +1 this. I'm already using it for checklists as plain markdown, and the format is pretty similar. I can see a lot of value to this as a semi-markdown compatible extension or second app sharing the codebase.
Re:Show HN: A plain-text file format for todos and check lists by haswell on Friday April 01, 2022 @12:28PM (#30880020)
> A formal spec also doesn't help much for apps to use this format. There is not a huge need for portability between to do apps...

To add some counterpoint to this, I try a lot of apps. Partially because I'm always looking for the one that's better than what I use now - looking for the thing that fits me the best - but also because I just like trying things.

Portability means a greater chance that I'll fully dive in and use an app to its potential vs. some light use.

There have been a few times that I've found a new app/solution that was clearly better than what I was currently using, and this was both exciting and frustrating. Frustrating because it meant I'd either have to leave my history behind, or spend a ton of time trying to port it over somehow.

I realize I'm part of a niche group of people, but I feel like a spec like this was meant for a pretty niche group of people.

I for one do not agree that this is unnecessary, but I do acknowledge that it's probably not necessary for a lot of people.

Re:Show HN: A plain-text file format for todos and check lists by jotaen on Friday April 01, 2022 @12:33PM (#30880081)
> I feel like a spec like this was meant for a pretty niche group of people.

That’s spot on actually.

Re:Show HN: A plain-text file format for todos and check lists by johnwalkr on Saturday April 02, 2022 @03:24AM (#30886460)
Portability and human readability in a normal text editor are huge plusses for me.

I mostly use paper notebooks, but when I need to keep track of todos over a long period of time for a specific thing, I like to have a text file located with that thing. With all of these cloud-based tools we now use, everything’s refactored to be organized based on tool, then project instead of project, then tool. I for one am starting to rethink this. Changing of tools or people, or simply passage of time inevitably loses information, or knowledge of where information was stored.

I could see myself using this format for simple tracking in a git repo where I don’t want to use GitHub or another similar tool. One use case would be getting things done in a JIRA/middle-management heavy organization.

Having the spec is then nice because anyone could use their preferred tool if they want to and one could easily check for open todos in a bunch of folders/repos.

Re:Show HN: A plain-text file format for todos and check lists by jotaen on Friday April 01, 2022 @12:32PM (#30880060)
I appreciate the criticism, thanks! I disagree, though, that adhering to standardised formats is not worth it. Currently, there are countless todo apps and editor plugins out there, which all do very similar things. However, each needs their own dedicated editor plugin for syntax highlighting, and you can’t easily switch the client apps without having to also switch the underlying data format.

What I agree with is that standards limit the creative freedom of tool creators. But that’s the same balancing act all over again, no matter where you look at.

Re:Show HN: A plain-text file format for todos and check lists by mufufu on Friday April 01, 2022 @12:44PM (#30880259)
I disagree, having the spec is the first step to building tooling around it. People can port plugins that support this format to vim, eMacs, VSC, etc.. and create functionality around it. For example: reorder into a date view
Re:Show HN: A plain-text file format for todos and check lists by thirdwhrldPzz on Friday April 01, 2022 @01:55PM (#30881187)
Still, why plain text? If the goal is “wrap it in UI” why a new white space, special characters.

Why not YAML or JSON and the vetted libraries to read and write the format?

As a user I don’t really have any concern with what underlying data format and structure it stores things in. I want to manage my todos!

This could be an SQLITE file for all I care.

Software engineering should be about more productive UX, not flexing one’s ability to parse arbitrary syntactic art.

Re:Show HN: A plain-text file format for todos and check lists by lobocinza on Friday April 01, 2022 @04:11PM (#30882785)
> Software engineering should be about more productive UX, not flexing one’s ability to parse arbitrary syntactic art.

Tasks lists are generally useless without their context. It makes sense to have tasks along their context (be it plain-text, markdown, JS, python...) Also it's more maintainable and portable. YAML/JSON/SQlite will be a headache when the user decide to migrate to another tool. This approach only require a text editor, any text editor in any platform. You can plug in whatever you prefer for syncing and sugar.

For a very few cases I use YAML to store data that isn't parsed by any program (only by me). And I can write a comment like 'TODO: Do something.' or "FIXME: X isn't working.' On the terminal using a code searcher and a text editor I can easily find and jump on those.

Re:Show HN: A plain-text file format for todos and check lists by thirdwhrldPzz on Saturday April 02, 2022 @10:22AM (#30888492)
UX creates context from the users perspective, not the back end data format. This format creates a headache in that nothing can parse or write it except the humans that learn it.

I can easily search an SQLITE file from a CLI (wrote me a tool a long time ago to fuzzy find). I doubt the YAML lib for Python is going to become obsolete soon. I can instantly work with that format on any machine with a common language. There’s already Taskwarrior.

It’s electrons in a machine, hundreds of different paths to porting it around, changing it, etc.

Look, don’t get me wrong; I’m not about to pour sugar down someone’s gas tank. I’m just walking through my inner monologue debating this format someone chose to put up for open review and discussion.

Re:Show HN: A plain-text file format for todos and check lists by lobocinza on Saturday April 02, 2022 @11:39AM (#30889020)
I write data that makes sense to have as normalized in YAML format even if I'm not parsing it in any program because I may do so in the future and YAML is ergonomic.

But for things that shouldn't be normalized I write then as plain-text notes using markdown notation. It isn't true that nothing can parse plain text. I wrote a tool to do that and it works as expected. Of course it's bad design if you look exclusively from the software engineering perspective but ergonomics also matter and parsing text isn't hard.

Don't get me wrong also. I'm just a guy with peculiar use cases and bad experiences migrating away from Evernote and later Joplin.

Re:Show HN: A plain-text file format for todos and check lists by jotaen on Friday April 01, 2022 @02:01PM (#30881282)
I think the viewpoints on that are wildly diverse. As far as I’m concerned, it’s the exact opposite. Hence, I think it’s great that there is a big variety of different approaches that everyone can pick from according to their own preferences.
Re:Show HN: A plain-text file format for todos and check lists by thirdwhrldPzz on Friday April 01, 2022 @02:23PM (#30881593)
Sure; I’m just expressing mine. The “glyphs and how to display or sort them wars” aren’t important enough to me to take real offense to alternatives. This is just idle discourse for me.

Lindy Effect type thoughts, why import another dependency; familiarity, existing portability, and habits with current formats; deep and wide tooling and language support… road built; let’s drive to shovel poetic drivel out the door.

Re:Show HN: A plain-text file format for todos and check lists by systemvoltage on Friday April 01, 2022 @01:07PM (#30880576)
I think the author is saying there is already a spec, just one abstraction layer above: Plain text. Anything that can read and write text can interact with the to-do list.

In some ways, it is more portable.

Re:Show HN: A plain-text file format for todos and check lists by posharma on Friday April 01, 2022 @02:17PM (#30881513)
Agree. Todo lists are ephemeral. They're not meant to be stored and archived. Just write the list already, execute the items in the list and move on. Focus on getting things done rather than creating new formats for these ephemeral lists.
Re:Show HN: A plain-text file format for todos and check lists by noizejoy on Friday April 01, 2022 @05:36PM (#30883562)
> Todo lists are ephemeral. They're not meant to be stored and archived.

I have many recurring items on my todo list. So those might be nice to be portable between apps.

Re:Show HN: A plain-text file format for todos and check lists by zamubafoo on Friday April 01, 2022 @12:34PM (#30880098)
I think that having a formal spec would help since a lot of the minutiae that is done to format and the like can be in the form of snippets in (nearly all) text editors used today.

So just having the autocompletion for people editing in text does wonders.

As for standardization, applications don't have to target it as their on-disk format for it to be useful. Instead of bespoke JSON/XML schemas or proprietary formats, having a plain text export format is a big win. Specially if it's human readable and human writeable.

Re:Show HN: A plain-text file format for todos and check lists by D13Fd on Friday April 01, 2022 @12:54PM (#30880408)
I'm not sure this is the best tool for an import-export format, as it is unable to capture all of the data available in some to do apps.

I could see it being OK as a sort-of data backup format. But it's missing a lot of data that really ought to be tracked by an app, like creation, update, and completion times for each item. Many apps also track priority, sort order, hidden/unhidden status, attachments, and other things. This stores none of that.

Even then, the value is fairly small. In 20+ years of using to do apps, I can think of very few times that I've referred back to completed to do items.

Re:Show HN: A plain-text file format for todos and check lists by oezi on Friday April 01, 2022 @12:54PM (#30880407)
I think it is nice when there is a well thought out spec for something. But in this particular case, I think it is not compatible enough with other tools.

In particular, Markdown has a todos (using the same `[ ]`) and just uses indentation for grouping. I find this more intuitive and it renders in markdown renderers.

For priorities, I have adopted the notation of OneNote which puts exclamation and Unicode star symbol next to the todo brackets.

I also use some other conventions:

[-] for obsolete rather than [~].

[>] for postponed until later

Implemented in my Todo manager TUI: https://github.com/coezbek/rodo

Re:Show HN: A plain-text file format for todos and check lists by randlet on Friday April 01, 2022 @01:31PM (#30880854)
> In particular, Markdown has a todos (using the same `[ ]`) and just uses indentation for grouping.

Came here to mention the same thing. I use a plain text todo format that is quite similar (thought not nearly so thought out/complete) to the one OP is proposing, but I use indentation for grouping as it's a lot easier for me to visually identify related groups of tasks.

Re:Show HN: A plain-text file format for todos and check lists by jonnycomputer on Friday April 01, 2022 @01:23PM (#30880763)
Might be right, but as an interchange format between todo-apps, might be worth it?
Re:Show HN: A plain-text file format for todos and check lists by eigenvalue on Friday April 01, 2022 @03:13PM (#30882158)
Where I think something like this is most useful is as a common interchange format. For example, if you are using TickTick as a todo app and decide you want to switch to using Notion or something. If there were an ecosystem of converters to this common format, that would make this trivial to do.
Re:Show HN: A plain-text file format for todos and check lists by smoe on Friday April 01, 2022 @12:32PM (#30880074)
A spec makes it more easy to build tooling around it. I reckon the people that love emacs org-mode, do so not mainly because of its specification, but the power to manipulate those plain text files in the editor.
Re:Show HN: A plain-text file format for todos and check lists by RankingMember on Friday April 01, 2022 @02:58PM (#30881998)
Agree, not everything needs a special format or spec. To me, it just obfuscates the core purpose of a to-do list for me, which is to record the bare essentials to remind me of things I need to do, then do them and forget about them. Anything else is just more overhead I don't need.