forked from nus-cs2103-AY2324S2/ip
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
A user guide helps consolidate all information regarding the program for all parties to read, be it new or experienced users.
- Loading branch information
1 parent
1e0bcb4
commit 623be30
Showing
8 changed files
with
103 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,30 +1,117 @@ | ||
# Duke User Guide | ||
# Tsundere User Guide | ||
|
||
// Update the title above to match the actual product name | ||
<img src="Ui.png" width="400" alt="Ui"> | ||
|
||
// Product screenshot goes here | ||
Watched too much anime but still can't get enough of your favourite tsundere waifu?<br> | ||
Look no further! Your friendly ~~(or not)~~ Tsundere chatbot assistant is here as your personal task manager! | ||
|
||
// Product intro goes here | ||
## Setting Up | ||
All you need to do is, | ||
1. Ensure you have Java `11` installed in your computer. [How to check](https://www.baeldung.com/java-check-is-installed) | ||
- If you do not have Java `11`, download it from [here](https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html) | ||
- Help with configuring correct Java version: [Windows](https://www.happycoders.eu/java/how-to-switch-multiple-java-versions-windows/) | [MacOS](https://stackoverflow.com/questions/21964709/how-to-set-or-change-the-default-java-jdk-version-on-macos) | [Linux](https://www.baeldung.com/linux/java-choose-default-version) | ||
1. Download the latest ``tsundere.jar`` release file from [here](https://github.com/macareonie/ip/releases/). | ||
1. Copy the downloaded file to the folder you want to use as the _home folder_ for your Tsundere Task Assistant. | ||
1. Double click the `tsundere.jar` file. Alternatively, for users with command line experience, open up your favourite terminal and navigate to the directory using `cd` and type the command `java -jar tsundere.jar`. | ||
|
||
## Adding deadlines | ||
Now the GUI would have popped up and you can start managing your tasks! | ||
|
||
// Describe the action and its outcome. | ||
## Adding Tasks | ||
|
||
// Give examples of usage | ||
There are three types of tasks which can you add: ToDos, Events and Deadlines. | ||
|
||
Example: `keyword (optional arguments)` | ||
__Format:__ | ||
- `todo [task]` | ||
- `event [task], from [ ], to [ ]` | ||
- `deadline [task], by [YYYY-MM-DD]` | ||
|
||
// A description of the expected outcome goes here | ||
__Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Adding events currently supports any input for the `from` and `to` fields | ||
- Adding deadlines currently supports only the data format `YYYY-MM-DD` | ||
|
||
``` | ||
expected output | ||
``` | ||
<br> | ||
|
||
## Feature ABC | ||
![img.png](add.png) | ||
|
||
// Feature details | ||
A confirmation response will be seen once a task has been successfully added with the notation `T`, `E` and `D` denoting _ToDos_, _Events_ and _Deadlines_ respectively. | ||
|
||
## Listing Tasks | ||
|
||
## Feature XYZ | ||
You can list all recorded tasks. | ||
|
||
// Feature details | ||
__Format:__ | ||
- `list` | ||
|
||
<br> | ||
|
||
![img.png](list.png) | ||
|
||
## Deleting Tasks | ||
|
||
You can delete tasks based on their index or task number. | ||
|
||
__Format:__ | ||
- `delete [task number]` | ||
|
||
|
||
__Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Inputting invalid task numbers will prompt you with the proper command format | ||
|
||
<br> | ||
|
||
![img.png](del.png) | ||
|
||
A confirmation response will be seen once a task has been successfully deleted. | ||
|
||
## Additional Features | ||
|
||
1. Marking and Unmarking tasks | ||
2. Tagging and Untagging tasks | ||
3. Finding tasks by keyword | ||
|
||
__Format:__ | ||
- `mark [task number]` | ||
- `unmark [task number]` | ||
- `tag [task number] [tag name]` | ||
- `untag [task number] [tag name]` | ||
- `find [keyword]` | ||
|
||
__Things to note:__ | ||
- Omit the square brackets `[]` when entering the commands | ||
- Inputting invalid task numbers will prompt you with the proper command format | ||
- You can tag each task with a maximum of 3 unique tags | ||
- The find command is currently case-sensitive | ||
|
||
<br> | ||
<img src="tag.png" width="400" alt="mark/tag"> | ||
|
||
Tasks are unmarked by default denoted with `[ ]` while marked tasks are denoted with `[X]`. | ||
<br> | ||
Tagged tasks have their tags appended after their description. Eg. `...borrow book #fun...`. | ||
|
||
<img src="find.png" width="400" alt="find"> | ||
|
||
## Getting help | ||
|
||
If you can't be bothered to read the rest of the User Guide or if you need help while using the program. `help` displays all the available commands. | ||
|
||
__Format:__ | ||
- `help` | ||
|
||
<br> | ||
<img src="help.png" width="400" alt="mark/tag"> | ||
|
||
## Exiting program and Saving data | ||
|
||
__Format:__ | ||
- `bye` | ||
|
||
Typing `bye` exits the program and automatically saves the current session data into a `data.txt` file. A new `data.txt` will be created if one doesn't exist already. | ||
|
||
## FAQ | ||
|
||
Q: Can I edit the data file directly or transfer it to another device? <br> | ||
A: Data storage is done by converting each task and their details to strings and parsing them when loading it for a new session. As such, invalid changes to the `data.txt` file could cause problems and it is not recommended to directly edit the file. | ||
To transfer data to another device, just copy the `data.txt` file to the `data` directory of the `tsundere.jar` file. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.