Skip to content

Commit

Permalink
Add UserGuide
Browse files Browse the repository at this point in the history
A user guide helps consolidate all information regarding the program for
all parties to read, be it new or experienced users.
  • Loading branch information
macareonie committed Feb 17, 2024
1 parent 1e0bcb4 commit 623be30
Show file tree
Hide file tree
Showing 8 changed files with 103 additions and 16 deletions.
119 changes: 103 additions & 16 deletions docs/README.md
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.
Binary file added docs/Ui.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/add.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/del.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/find.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/help.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/tag.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 623be30

Please sign in to comment.