Completion date: Optional or not?

[ptosi]

The illustration of the todo.txt format states

Optional - Completion Date

while the definition of the format for complete tasks states that the completion date is required:

With the completed date (required), if you've used the prepended date (optional), you can calculate how many days it took to complete a task.

Therefore, is the "Optional" supposed to mean "depending on the completion status of the task" or is this a discrepancy? In particular, can a complete task omit its completion date?

[davidstosik]

I'm confused as well, and here are two more lines that add to the confusion (emphasis mine):

Optional -- Creation date (must be specified if completion date is)

If you’ve prepended the creation date to your task, on completion it will appear directly after the completion date.

So far we have:

• creation date is optional
• completion date must be provided when the task is completed (x)
• creation date must be provided when the completion date is

Problem 💥

Now, what happens when I complete the task call mom (nothing more on the todo.txt line, especially no creation date, as it is optional)?

1. Completed date is required, so I need to add it:

   x 2019-07-03 call mom

2. But now, as completion date is provided, creation date must be specified too, but I don't have it!

   x 2019-07-03 ????-??-?? call mom

Interpretation 💭

My take, which does not perfectly match the spec (no logical interpretation can, in my opinion) is that:

• creation date is optional (never required): if it is optional on incomplete tasks, it cannot reasonably be required on complete tasks
• completion date does not make sense for incomplete tasks
• completion date is required on completed tasks
• creation date may stick to completed tasks, or be removed, to the writer's liking

Valid ✅

• call mom: when incomplete, no date is required
• 2019-07-01 call mom: the provided date is the creation date
• x 2019-07-03 call mom: the provided date is the completion date
• x 2019-07-03 2019-07-01 call mom: the provided dates are, in order, completion then creation

Invalid ❌

• 2019-07-03 2019-07-01 call mom: the task is incomplete, so can't have a completion date
• x call mom: a completed task needs at least a completion date

Arguable point

My personal interpretation states that completion date is required when a task is complete. Some people might be happy to just x out a completed task without having to input more text.