Skip to content

Commit

Permalink
Merge pull request #183 from Eru111/Update-userguide
Browse files Browse the repository at this point in the history
Update UG with new features
  • Loading branch information
Eru111 authored Nov 7, 2024
2 parents b46cddf + 05747bc commit 213cefe
Showing 1 changed file with 91 additions and 14 deletions.
105 changes: 91 additions & 14 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,13 +127,16 @@ Examples:
</box>

### Listing all contacts : `list`
**<ins>When in the main window**

**<ins>When in the main or inspect window**

Takes you back to the main window, and shows a list of all contacts added to the contacts list.
Shows a list of all contacts added to the contacts list.

Format: `list`

**<ins>When in the inspect window**

Shows a list of all deliveries added to a contact's delivery list. Format is the same as in the main window.

### Editing a contact or delivery: `edit`
**<ins>When in the main window**

Expand Down Expand Up @@ -164,7 +167,7 @@ Examples:
* `edit 1 i/Speaker c/$50` changes the items and cost of the 1st delivery to be `Speaker` and `$50` respectively.
* `edit 2 s/delivered t/` changes the status of the 2nd delivery to be `delivered` and clears all of its tags.

### Locating contacts or deliveries by name: `find`
### Locating contacts by name: `find`
**<ins>When in the main window**

Finds contacts whose names contain any of the given keywords.
Expand All @@ -186,6 +189,24 @@ Examples:

Find command does not work in the inspect window.

### Locating deliveries by item: `finddel`
**<ins>When in the main window**

`finddel` does not work in the main window.

**<ins>When in the inspect window**

Finds deliveries that contain any of the given items.

Format: `finddel ITEM [MORE_ITEMS]`
* **Case-insensitive search**: The search does not distinguish between upper or lower case. e.g `mouse` will match `Mouse`
* **Keyword order does not matter**: You can enter keywords in any order. e.g. `Mouse Monitor` will match `Monitor Mouse`
* **"OR" search**: If a delivery contains any of the items, it will be shown. e.g. `Mouse Monitor` will return `Mouse Chair`, `Monitor Desk`

Examples:
* `finddel Chair` returns any delivery that contains the item chair.
* `find Chair Desk` returns any delivery that contains the item chair, desk, or both.

### Archiving a contact or delivery : `archive`
**<ins>When in the main window**

Expand Down Expand Up @@ -315,6 +336,54 @@ Examples:

`inspect` does not work in the inspect window.

### Assigning a delivery to an employee : `assign`
**<ins>When in the main window**

`assign` does not work in the main window.

**<ins>When in the inspect window**

Assigns the specified delivery from the delivery list of a client to the specified employee. It does not work when inspecting an employee.

Format: `assign INDEX n/EMPLOYEE_NAME`

* Assigns the delivery at the specified `INDEX` to the employee specified by `EMPLOYEE_NAME`.
* The index is the number displayed at the top of a delivery in the delivery list of a contact.
* The index **must be a positive number** (starting from 1).
* The worker name should match an existing worker in the contact list.

Examples:
* `assign 1 n/Betsy Crowe` assigns first delivery of the current contact to employee Betsy Crowe.

### Remove delivery from employee : `remove`
**<ins>When in the main window**

`remove` does not work in the main window.

**<ins>When in the inspect window**

Removes the specified delivery from the delivery list of an employee. It does not work when inspecting a client.

Format: `remove INDEX`

* Removes the delivery at the specified `INDEX` from the current employee's delivery list.
* The index is the number displayed at the top of a delivery in the delivery list of a contact.
* The index **must be a positive number** (starting from 1).

Examples:
* `remove 1` removes the first delivery of the current employee's delivery list.

### Returning to the main window : `back`
**<ins>When in the main window**

`back` does not do anything in the main window.

**<ins>When in the inspect window**

Takes you back to the main window.

Format: `back`

### Clearing all entries : `clear`
**<ins>When in the main or inspect window**

Expand Down Expand Up @@ -368,16 +437,22 @@ Furthermore, certain edits can cause the LogiLink to behave in unexpected ways (

Action | Format, Examples
-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------
**Add** | `add n/NAME p/PHONE_NUMBER e/EMAIL r/ROLE a/ADDRESS [t/TAG]…​` <br> e.g., `add n/James Ho p/22224444 e/[email protected] r/Client a/123, Clementi Rd, 1234665 t/friend t/colleague`
**Archive**| `archive INDEXES`<br> e.g., `archive 3`, `archive 3 4`
**Clear** | `clear`
**Delete** | `delete INDEXES`<br> e.g., `delete 3`, `delete 3 4`
**Edit** | `edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]…​`<br> e.g.,`edit 2 n/James Lee e/[email protected]`
**Find** | `find KEYWORD [MORE_KEYWORDS]`<br> e.g., `find James Jake`
**Inspect**| `inspect INDEX`<br> e.g., `inspect 2`
**List** | `list`
**Help** | `help`
**Unarchive**| `unarchive INDEXES`<br> e.g., `unarchive 3`, `unarchive 3 4`
**Add** | <ins>Main Window:</ins><br> `add n/NAME p/PHONE_NUMBER e/EMAIL r/ROLE a/ADDRESS [t/TAG]…​` <br> e.g., `add n/James Ho p/22224444 e/[email protected] r/Client a/123, Clementi Rd, S123456 t/friend t/colleague` <br><ins>Inspect Window:</ins><br> `add i/ITEM…​ e/ETA a/ADDRESS c/COST s/STATUS [t/TAG]…​` <br> e.g., `add i/Monitor i/Mouse e/2020-02-02 a/311, Clementi Ave 2, #02-25, S120300 c/$100 s/not delivered t/Difficult address to deliver`
**Archive**| <ins>Both Windows:</ins><br> `archive INDEXES`<br> e.g., `archive 3`, `archive 3 4`
**Assign** | <ins>Main Windows:</ins><br> Does not work <br><ins>Inpsect Windows:</ins><br> `assign INDEX n/EMPLOYEE_NAME` <br> e.g., `assign 1 n/Betsy Crowe`
**Back** | <ins>Both Windows:</ins><br> `back`
**Clear** | <ins>Both Windows:</ins><br> `clear`
**Delete** | <ins>Both Windows:</ins><br> `delete INDEXES`<br> e.g., `delete 3`, `delete 3 4`
**Edit** | <ins>Main Window:</ins><br> `edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]…​`<br> e.g.,`edit 2 n/James Lee e/[email protected]` <br><ins>Inspect Window:</ins><br> `edit INDEX [i/ITEM]…​ [e/ETA] [a/ADDRESS] [c/COST] [s/STATUS] [t/TAG]…​` <br> e.g., `edit 1 i/Speaker c/$50`
**Find** | <ins>Main Window:</ins><br> `find KEYWORD [MORE_KEYWORDS]`<br> e.g., `find James Jake` <br><ins>Inspect Window:</ins><br> Does not work
**Find Delivery**| <ins>Main Window:</ins><br> Does not work <br><ins>Inspect Window:</ins><br> `finddel ITEM [MORE_ITEMS]` e.g., `finddel Monitor Mouse`
**Help** | <ins>Both Windows:</ins><br> `help`
**Inspect**| <ins>Main Window:</ins><br> `inspect INDEX`<br> e.g., `inspect 2` <br><ins>Inspect Window:</ins><br> Does not work
**List** | <ins>Both Windows:</ins><br> `list`
**Remove** | <ins>Main Window:</ins><br> Does not work <br><ins>Inspect Window:</ins><br> `remove INDEX` e.g., `remove 1`
**Sort Ascending**| <ins>Both Windows:</ins><br> `asort by/ATTRIBUTE`
**Sort Descending**| <ins>Both Windows:</ins><br> `dsort by/ATTRIBUTE`
**Unarchive**| <ins>Both Windows:</ins><br> `unarchive INDEXES`<br> e.g., `unarchive 3`, `unarchive 3 4`

--------------------------------------------------------------------------------------------------------------------

Expand All @@ -387,3 +462,5 @@ Terms | Meaning
-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------
**Archive** |The action of moving an item, from an active or accessible state to a preserved state by reducing its immediate availability and visibility.
**Unarchive** |The action of restoring a previously archived item, to an active or accessible state.
**Client** |A contact that has the role `client`
**Employee** |A contact that has the role `employee`

0 comments on commit 213cefe

Please sign in to comment.