nus-cs2103-AY2021S2 / pe-dev-response

0 stars 0 forks source link

Difference between BackLog and Todo #2475

Open nus-pe-bot opened 3 years ago

nus-pe-bot commented 3 years ago

Note from the teaching team: This bug was reported during the Part II (Evaluating Documents) stage of the PE. You may reject this bug if it is not related to the quality of documentation.


The difference between BackLog and Todo does not seem clear as a user reading the DG, or UG. Perhaps more explanation would be better. If there is not too much difference, can consider removing one of the 2 categories.

image.png


[original: nus-cs2103-AY2021S2/pe-interim#2475] [original labels: severity.High type.DocumentationBug]

nhzaci commented 3 years ago

Team's Response

Having a backlog, todo, in progress and done is in line with Agile kanban boards, such as Jira.

The backlog serves as a longer term todo list where it's not currently about to be worked on in the near future, but are still tasks that require the user's attention to complete eventually but do not want to lose track of exactly what is left over.

The todo serves as a short term todo list where the user is actively working through the list to ensure they are able to complete all of their tasks.

Additionally, this is in the glossary of the developer's guide, so we are just explaining the terms to developers, while if a developer wants a better understanding of agile methodologies of project management, it is expected that they should do reading up outside of our developer's guide.

According to CS2103T guidelines on bugs in the DG:

Problems in Glossary. Examples:

  • Unnecessary terms included
  • Important terms missing

This belongs to neither of those.

Duplicate status (if any):

--