Skip to content

"note" command should be "annotate" #180

Description

@axelsimon

Hi,
All of what I'm about to say is probably personal, but I thought I'd share.
I think there's a small inconsistency in how the dstask note command is named.

If you look at dstask commands, they fall more or less in one of three basic categories:

  • filter (next, show-tags, show-*.)
  • action (add, log, start, stop, done, modify, edit, undo, sync, open and… note)
  • other (git, template, bash-completion, help, version)

"note" is an action, but its command is not a verb, unlike essentially all the other.
There is an exception with "done", but I'd argue that "done" is specific enough that it's not surprising and still makes sense, although it could helpfully have dstask resolve as a synonym, for consistency.

When looking to add a note, I want to tell dstask to "annotate", and not to "note".
If "note" must exist, i'd expect "note" to display the notes about a task, more like a "filter" subcommand.

Am I over-thinking this?

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions