Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update user guide #122

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
177 changes: 129 additions & 48 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,94 +31,175 @@ list via a Command Line Interface**.

{Give detailed description of each feature}

### Display Commands : `help`
### `help` - Display the commands
Displays the features of OmniTravel

Format: `help`

Example of usage:

`help`

### Adding a general travel activity : `add`
Adds a general travel activity into the travel activity list
Expected outcome:

```
____________________________________________________________
These are the available commands!
1. list
2. help
3. bye
4. add <travel activity> <date> <duration> <tag>
5. accommodation <travel activity> <date> <duration> <tag>
6. food <travel activity> <date> <duration> <tag>
7. landmark <travel activity> <date> <duration> <tag>
8. delete <activity number>
9. find <keyword>
10. check <activity number>
11. uncheck <activity number>
12. tag <activity number> <tag name>
13. untag <activity number>
14. update <update> <date> <duration> <tag>
15. findtag <tag name>
16. findtype <type>
17. expense <activity number> <expense amount>
18. removeexpense <activity number>
____________________________________________________________
```
### `list` - Lists out the current activity list

After you type `list`, the chatbot will output the current activity list

Format: `add DESCRIPTION /date YYYY-MM-DD /duration DURATION [/tag TAG]`
Example of usage:

Examples of usage:
* `add Go to Japan /date 2024-03-14 /duration 7 hours`
* `add Go to Hong Kong /date 2024-08-25 /duration 6 hours /tag with family`
`list`

### Deleting a travel activity : `delete`
Deletes a travel activity from the travel activity list
Expected outcome:

Format: `delete INDEX`
* `INDEX` has to be a number that is shown in the list of travel activities
```
____________________________________________________________
Here are the travel activities in your list:
[ ] 1. paris :12 Dec 2023 :1 (hello) ($50)
[ ] 2. japan :12 Dec 2023 :now ($100)
____________________________________________________________
```

Examples of usage: `delete 1`
### `add` - add a general activity into the list

### Listing all the travel activities : `list`
Shows all the travel activities including their tags and expenses
After you type `add DESCRIPTION /date YYYY-MM-DD /duration DURATION [/tag TAG]`, the chatbot will input your general
activity into the activity list

Format: `list`
Example of usage:

Examples of usage: `list`
Without tags

### Updating a travel activity : `update`
Updates the date, duration and tag of a travel activity
`add visit paris /date 2024-12-12 /duration 2 weeks`

Format: `update INDEX /date YYYY-MM-DD /duration DURATION [/tag TAG]`
* `INDEX` has to be a number that is shown in the list of travel activities
With tags

Examples of usage:
* `update 1 /date 2019-12-14 /duration 2 hours`
* `update 2 /date 2018-12-12 /duration 3 hours /tag Important`
`add visit paris /date 2024-12-12 /duration 2 weeks /tag first country`

### Adding a tag: `tag`
Adds a new tag to an existing travel activity.
Expected outcome:

Format: `tag n/ACTIVITY_NUMBER d/TAG_NAME`
```
____________________________________________________________
I added a new travel activity
visit paris :12 Dec 2024 :2 weeks
____________________________________________________________
```

* The `ACTIVITY_NUMBER` must be a valid activity number.
### `accommodation` - add an accommodation activity type into the list

Example of usage:
After you type `accommodation`, adds an accommodation activity into the list

`tag n/1 d/activity 1`
Example of usage:

### Removing a tag: `untag`
Removes a tag from an existing travel activity.
Without tags

Format: `untag n/ACTIVITY_NUMBER`
`accommodation four seasons hotel /date 2024-12-12 /duration 2 weeks`

* The `ACTIVITY_NUMBER` must be a valid activity number.
With tags

Example of usage:
`add four seasons hotel /date 2024-12-12 /duration 2 weeks /tag first hotel`

Expected outcome:

`untag n/1 `
```
____________________________________________________________
I added a new accommodation
Accommodation: four seasons hotel :12 Dec 2024 :2 weeks
____________________________________________________________

### Adding an expense amount: `expense`
Adds an expense amount to an existing travel activity.
```

Format: `expense n/ACTIVITY_NUMBER d/EXPENSE_AMOUNT`
### `food` - add a food activity type into the list

* The `ACTIVITY_NUMBER` must be a valid activity number
* The `EXPENSE_AMOUNT` can include the currency of the expense.
After you type `food`, adds a food activity into the list

Example of usage:

`expense n/1 d/$50`
Without tags

`food Hells Kitchen /date 2024-12-12 /duration 2 hours`

### Removing an expense amount: `removeexpense`
Removes an expense amount to an existing travel activity.
With tags

Format: `removeexpense n/ACTIVITY_NUMBER`
`add Hells Kitchen /date 2024-12-12 /duration 2 hours /tag Meet Gordon Ramsay`

* The `ACTIVITY_NUMBER` must be a valid activity number.
Expected outcome:

```
____________________________________________________________
I added a new restaurant
Food: Hells Kitchen :12 Dec 2024 :2 hours
____________________________________________________________

```
### `landmark` - add a landmark activity type into the list

After you type `landmark`, adds a landmark activity into the list

Example of usage:

`removeexpense n/2`
Without tags

`landmark Eiffel Tower /date 2024-12-12 /duration 2 hours`

With tags

`landmark Eiffel Tower /date 2024-12-12 /duration 2 hours /tag go up tower`

Expected outcome:

```
____________________________________________________________
I added a new landmark
Landmark: Eiffel Tower :12 Dec 2024 :2 hours
____________________________________________________________

```

### `find` - find an activity in the list using a keyword


### `delete` - delete an existing activity from the list

### `check` - check an activity from the list to mark as done

### `uncheck` - uncheck an activity from the list to mark as not done

### `update` - update an existing activity in the list

### `tag` - add a tag to an existing activity in the list

### `untag` - remove a tag from an existing activity in the list

### `findtag` - find an activity through its tag

### `findtype` - find all activities of the same type

### `expense` - add an expense to an activity in the list

### `removeexpense` - remove an expense from an activity in the list

### `bye` - exits the chatbot

## FAQ

Expand Down
9 changes: 7 additions & 2 deletions omni.txt
Original file line number Diff line number Diff line change
@@ -1,2 +1,7 @@
general / 0 / paris / 2023-12-12 / 1 / hello / $50
general / 0 / japan / 2023-12-12 / now / / $100
general / 0 / visit paris / 2024-12-12 / 2 weeks / /
general / 0 / visit paris / 2024-12-12 / 2 weeks / first /
general / 0 / visit paris / 2024-12-12 / 2 weeks / first country /
general / 0 / visit paris / 2024-12-12 / 2 weeks / first country /
accommodation / 0 / four seasons hotel / 2024-12-12 / 2 weeks / /
food / 0 / Hells Kitchen / 2024-12-12 / 2 hours / /
landmark / 0 / Eiffel Tower / 2024-12-12 / 2 hours / /
Loading