Skip to content

the-scott-davis/todo.md

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

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.

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 wants to know about the project's plans and work needs to be done.

Why not using online management tools?

Most often, 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 large projects efficiently, using them in early stages will add more effort and overhead for an MVP Product.

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, estimate, 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  
### Column Name
- Task title ~3d #type @name yyyy-mm-dd  
  - Sub-task or description  

### Completed Column ✓
- Completed task title  

See also

About

TODO.md file format

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published