TODO.md

What is TODO.md?

• The TODO.md format is based on GFM - GitHub Flavored Markdown - Task Lists.
• TODO.md is a file that contains tasks organized in multiple sections.
• Tasks in TODO.md can be visualized using Kanban Board where sections become columns on the board.
• Inspired by Keep a Changelog

Why keep a TODO.md?

For a project, there any many sources of information like Documentation, Issue forum, Wiki pages, etc. It is hard to find out about the current progress.

Keeping a TODO.md file makes it easier for anyone who wants to know about the project's plans and work that needs to be done.

Why not using online management tools?

Often times, a new project starts with a list of tasks to outline what needs to be done quickly.

Although some online tools are useful to manage larger projects efficiently, using them in the early stages will add more effort and overhead for small projects.

A few other reasons like: portable plain text format, same project directory, offline working, privacy, versioning (using git), minimalist tool, etc.

TODO.md format

• TODO.md can have multiple columns.
• Each column has tasks that start with a checkbox sign - [ ] or just a hyphen -
• Completed column name must contain ✓ or [x].
• There are "2 spaces" at the end of every task title to serve as line breaks on Github pages.
• Tags, mentions, estimates, date time, ticket id, etc. can be entered at the end of the task title.
• A task with 2 space indentation in the title is a sub-task or description.

# Project Name
Project Description

### Column Name
- [ ] Task title ~3d #type @name yyyy-mm-dd  
  - [ ] Sub-task or description  

### Completed Column ✓
- [x] Completed task title  

• Checkboxes are used as described in GFM - GitHub Flavored Markdown - Task Lists but they are optional.
• A task list without checkboxes look like this:

### Column Name
- Task title ~3d #type @name yyyy-mm-dd  
  - Sub-task or description  

### Completed Column ✓
- Completed task title  

See also

• An example of TODO.md
• Vscode Kanban Extension