|
1 | 1 | # User Guide |
| 2 | +> Greetings, Empress. I am Shinsoo, a divine bot from Ereve. It is an honor to be in your presence. |
| 3 | +
|
| 4 | +Shinsoo is a desktop app for task management, optimized for use via a Command Line Interface (CLI) while still having the benefits of a Graphical User Interface (GUI). If you can type fast, Shinsoo can get your task management done faster than traditional GUI apps. |
| 5 | + |
| 6 | +- [Quick Start](#quick-start) |
| 7 | +* [Features](#features) |
| 8 | + - [Feature - Add Tasks](#feature---add-tasks) |
| 9 | + - [Feature - List](#feature---list) |
| 10 | + - [Feature - Find](#feature---find) |
| 11 | + - [Feature - Marking](#feature---marking) |
| 12 | + - [Feature - Delete](#feature---delete) |
| 13 | + - [Feature - Exit](#feature---exit) |
| 14 | ++ [Command Summary](#command-summary) |
| 15 | + |
| 16 | +## Quick Start |
| 17 | +1. Ensure you have Java 11 or above installed in your Computer. |
| 18 | +2. Download the latest addressbook.jar from here. |
| 19 | +3. Copy the file to the folder you want to use as the home folder for your task management app. |
| 20 | +4. Open a command terminal, cd into the folder you put the jar file in, and use the java -jar addressbook.jar command to run the application. |
| 21 | +A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data. |
| 22 | + |
| 23 | +5. Type the command in the command box and press Enter to execute it. |
| 24 | +6. Refer to the Features below for details of each command. |
2 | 25 |
|
3 | 26 | ## Features |
4 | 27 |
|
5 | | -### Feature-ABC |
| 28 | +### Feature - Add Tasks |
| 29 | + |
| 30 | +Adds a task to the app. |
| 31 | + |
| 32 | +Format: <br/> |
| 33 | +`todo DESCRIPTION`<br/> |
| 34 | +`deadline DESCRIPTION /by DATE`<br/> |
| 35 | +`event DESCRIPTION /from DATE /to DATE`. |
| 36 | + |
| 37 | +Examples: <br/> |
| 38 | +`event trip to Langkawi /from 2023-02-21 /to 2023-02-27` |
| 39 | + |
| 40 | +--- |
| 41 | +### Feature - List |
| 42 | + |
| 43 | +Shows a list of all the tasks. |
| 44 | + |
| 45 | +Format: <br/> |
| 46 | +`list` |
| 47 | + |
| 48 | +--- |
| 49 | +### Feature - Find |
| 50 | + |
| 51 | +Find tasks via certain criteria. |
| 52 | + |
| 53 | +**keyword** <br/> |
| 54 | +Format: <br/> |
| 55 | +`find DESCRIPTION` |
| 56 | + |
| 57 | +Examples: <br/> |
| 58 | +`find trip` |
| 59 | + |
| 60 | +**deadline** <br/> |
| 61 | +Format: <br/> |
| 62 | +`findBy DATE` |
| 63 | + |
| 64 | +Examples: <br/> |
| 65 | +`findBy 2023-02-25` |
| 66 | + |
| 67 | +**day** <br/> |
| 68 | +Format: <br/> |
| 69 | +`viewSchedule DATE` |
| 70 | + |
| 71 | +Examples: <br/> |
| 72 | +`viewSchedule 2023-02-25` |
| 73 | + |
| 74 | +--- |
| 75 | +### Feature - Marking |
6 | 76 |
|
7 | | -Description of the feature. |
| 77 | +Marks a task from the app. |
8 | 78 |
|
9 | | -### Feature-XYZ |
| 79 | +Format: <br/> |
| 80 | +`mark INDEX` <br/> |
| 81 | +`unmark INDEX` |
10 | 82 |
|
11 | | -Description of the feature. |
| 83 | +Examples: <br/> |
| 84 | +`mark 1` |
12 | 85 |
|
13 | | -## Usage |
| 86 | +--- |
| 87 | +### Feature - Delete |
14 | 88 |
|
15 | | -### `Keyword` - Describe action |
| 89 | +Deletes a task from the app. |
16 | 90 |
|
17 | | -Describe the action and its outcome. |
| 91 | +Format: <br/> |
| 92 | +`delete INDEX` |
18 | 93 |
|
19 | | -Example of usage: |
| 94 | +Examples: <br/> |
| 95 | +`delete 1` |
20 | 96 |
|
21 | | -`keyword (optional arguments)` |
| 97 | +--- |
| 98 | +### Feature - Exit |
22 | 99 |
|
23 | | -Expected outcome: |
| 100 | +Exit the program. |
24 | 101 |
|
25 | | -Description of the outcome. |
| 102 | +Format: <br/> |
| 103 | +`bye` |
26 | 104 |
|
27 | | -``` |
28 | | -expected output |
29 | | -``` |
| 105 | +## Command Summary |
| 106 | +| Action | Format | |
| 107 | +|--------|----------------------------| |
| 108 | +| Add | `todo DESCRIPTION`, `deadline DESCRIPTION`, `event DESCRIPTION /from DATE /to DATE`| |
| 109 | +| List | `list` | |
| 110 | +| Find | `find DESCRIPTION`, `findBy DATE`, `viewSchedule DATE`| |
| 111 | +| Marking | `mark INDEX`, `unmark INDEX`| |
| 112 | +| Delete | `delete INDEX` | |
| 113 | +| Exit | `bye` | |
0 commit comments