From c73a2f60d53e808a89b31f678cb2b1dc14ff85e1 Mon Sep 17 00:00:00 2001 From: Ibnu Taimiyyah Date: Tue, 20 Feb 2024 20:18:54 +0800 Subject: [PATCH] Update User Guide --- adam.txt | 4 +- docs/README.md | 149 ++++++++++++++++++++++++++++++++++++++++++++----- 2 files changed, 137 insertions(+), 16 deletions(-) diff --git a/adam.txt b/adam.txt index 166f5b6818..a0d231cede 100644 --- a/adam.txt +++ b/adam.txt @@ -1,3 +1 @@ -T,0,Go to school -D,1,Submit hw,2024-02-02 -E,0,Trip,next week,next month +D,0,Submit hw,2024-02-02 diff --git a/docs/README.md b/docs/README.md index 47b9f984f7..bea923302b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,30 +1,153 @@ -# Duke User Guide +# Adam User Guide -// Update the title above to match the actual product name +Adam is a desktop app for **managing tasks, optimised for use via a Command Line Interface** (CLI) while still having the +benefits of a Graphical user Interface (GUI). -// Product screenshot goes here +## Adding todos -// Product intro goes here +Adds a todo task to the list of tasks. + +Format: `todo DESCRIPTION` + +Example: `todo buy groceries` + +Expected output: +``` +Got it, I've added this task: +[T][] buy groceries +Now you have 1 task(s) in the list. +``` ## Adding deadlines -// Describe the action and its outcome. +Adds a deadline task to the list of tasks. + +Format: `deadline DESC /by DATE` + +- `DATE` must be in the format **YYYY-MM-DD**. e.g. 2024-02-02 to represent 2 February 2024 + +Example: `deadline submit hw /by 2024-02-02` + +Expected output: +``` +Got it. I've added this task: +[D][] submit hw (by: 2 Feb 2024) +Now you have 2 task(s) in the list. +``` + +## Adding events + +Adds an event task to the list of tasks. + +Format: `event DESCRIPTION /from START /to END` + +- `START` and `END` can be any string + +Example: `event meeting /from 4pm /to 6pm` + +Expected output: +``` +Got it. I've added this task: +[E][] meeting (from: 4pm to: 6pm) +Now you have 3 task(s) in the list. +``` + +## Listing all tasks + +Shows a list of all tasks. + +Format: `list` + +Expected output: +``` +Here are your tasks: +1. [T][] buy groceries +2. [D][] submit hw (by: 2 Feb 2024) +3. [E][] meeting (from: 4pm to: 6pm) +``` + +## Marking tasks as done -// Give examples of usage +Marks a task as done. -Example: `keyword (optional arguments)` +Format: `mark INDEX` -// A description of the expected outcome goes here +- Marks the task at the specified `INDEX` as done. +- The index refers to the index number shown in the displayed list. +- The index **must be a positive integer** 1, 2, 3, ... +Example: `mark 1` marks the 1st task as done. + +Expected output: +``` +Nice, I've marked this task as done: +[T][X] buy groceries +``` + +## Marking tasks as not done + +Marks a task as not done. + +Format: `unmark INDEX` + +- Marks the task at the specified `INDEX` as not done. +- The index refers to the index number shown in the displayed list. +- The index **must be a positive integer** 1, 2, 3, ... + +Example: `unmark 1` marks the 1st task as not done. + +Expected output: +``` +Ok, I've marked this task as not done: +[T][] buy groceries +``` + +## Deleting tasks + +Deletes a task from the list. + +Format: `delete INDEX` + +- Deletes the task at the specified `INDEX`. +- The index refers to the index number shown in the displayed list. +- The index **must be a positive integer** 1, 2, 3, ... + +Example: `delete 1` deletes the 1st task in the list. + +Expected output: ``` -expected output +Ok, I've removed this task: +[T][] buy groceries +Now you have 2 task(s) in the list. ``` -## Feature ABC +## Finding tasks -// Feature details +Finds the tasks that contain a certain keyword +Format: `find KEYWORD` -## Feature XYZ +- The search is case-sensitive. e.g. `submit` will not match `Submit`. +- Only the description is searched. -// Feature details \ No newline at end of file +Example: `find submit` shows a list of all tasks that contain the word 'submit' in their description. + +Expected output: +``` +Here are the matching tasks in your list: +[D][] submit hw (by: 2 Feb 2024) +``` + +## Exiting the program + +Exits the program. + +Format: `bye` + +- Tasks are saved automatically when exiting the program. +- The program will terminate shortly after displaying the goodbye message. + +Expected output: +``` +Bye. Hope to see you again soon! +``` \ No newline at end of file