Skip to content

Commit

Permalink
Merged
Browse files Browse the repository at this point in the history
  • Loading branch information
willowisp01 committed Feb 29, 2024
2 parents a1ea9e5 + c62543a commit 60bf68d
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 38 deletions.
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[![CI Status](https://github.com/se-edu/addressbook-level3/workflows/Java%20CI/badge.svg)](https://github.com/se-edu/addressbook-level3/actions)
[![CI Status](https://github.com/AY2324S2-CS2103T-T09-1/tp/workflows/Java%20CI/badge.svg)](https://github.com/se-edu/addressbook-level3/actions)

[![codecov](https://codecov.io/gh/AY2324S2-CS2103T-T09-1/tp/graph/badge.svg?token=7WFJBKE6LA)](https://codecov.io/gh/AY2324S2-CS2103T-T09-1/tp)

Expand All @@ -15,5 +15,6 @@
* It is **written in OOP fashion**. It provides a **well-written** code base of around 10k LOC.
* It comes with a **reasonable level of user and developer documentation**.
* It is named **“TeachStack”** as a pun on heap and stack.

* For the detailed documentation of this project, see the **[TeachStack Product Website](https://ay2324s2-cs2103t-t09-1.github.io/tp/)**.
* This project is based on the AddressBook-Level3 project created by the [SE-EDU initiative](https://se-education.org).
65 changes: 28 additions & 37 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ AddressBook Level 3 (AB3) is a **desktop app for managing contacts, optimized fo

1. Ensure you have Java `11` or above installed in your Computer.

1. Download the latest `addressbook.jar` from [here](https://github.com/se-edu/addressbook-level3/releases).
1. Download the latest `TeachStack.jar` from [here](https://github.com/se-edu/addressbook-level3/releases).

1. Copy the file to the folder you want to use as the _home folder_ for your AddressBook.

1. 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.<br>
1. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar TeachStack.jar` command to run the application.<br>
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.<br>
![Ui](images/Ui.png)

Expand Down Expand Up @@ -51,11 +51,7 @@ AddressBook Level 3 (AB3) is a **desktop app for managing contacts, optimized fo
* Items in square brackets are optional.<br>
e.g `n/NAME [t/TAG]` can be used as `n/John Doe t/friend` or as `n/John Doe`.

* Items with ``​ after them can be used multiple times including zero times.<br>
e.g. `[t/TAG]…​` can be used as ` ` (i.e. 0 times), `t/friend`, `t/friend t/family` etc.

* Parameters can be in any order.<br>
e.g. if the command specifies `n/NAME p/PHONE_NUMBER`, `p/PHONE_NUMBER n/NAME` is also acceptable.
* Parameters must be in specified order.<br>

* Extraneous parameters for commands that do not take in parameters (such as `help`, `list`, `exit` and `clear`) will be ignored.<br>
e.g. if the command specifies `help 123`, it will be interpreted as `help`.
Expand All @@ -74,40 +70,37 @@ Format: `help`

### Adding a person: `add`

Adds a person to the address book.
Adds student details to the address book.

Format: `add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]`
Format: `add id/STUDENT_ID n/NAME e/EMAIL g/GRADE [t/TAG]​`

<div markdown="span" class="alert alert-primary">:bulb: **Tip:**
A person can have any number of tags (including 0)
</div>
* Name, student_id, grade, and email must have.
* Name can be case-insensitive, eg. john doe, JOHN DOE same as John Doe
* Email must have the correct format and string length of 8 for the email username eg. [email protected]
* Grade: [A+, A, A-, B+, B, B-, C+, C, D+, D, F]
* Student_id must start with A and end with a letter, string length of 9 eg. A0000000X

Examples:
* `add n/John Doe p/98765432 e/[email protected] a/John street, block 123, #01-01`
* `add n/Betsy Crowe t/friend e/[email protected] a/Newgate Prison p/1234567 t/criminal`

### Listing all persons : `list`
* `add id/A01234567H n/John Doe e/[email protected]`

Shows a list of all persons in the address book.

Format: `list`

### Editing a person : `edit`

Edits an existing person in the address book.

Format: `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [t/TAG]…​`
Format: `edit [id/STUDENT_ID] [e/EMAIL] `

* Edits the person at the specified `INDEX`. The index refers to the index number shown in the displayed person list. The index **must be a positive integer** 1, 2, 3, …​
* At least one of the optional fields must be provided.
* Existing values will be updated to the input values.
* When editing tags, the existing tags of the person will be removed i.e adding of tags is not cumulative.
* You can remove all the person’s tags by typing `t/` without
specifying any tags after it.
* Edits the person with the specified `STUDENT_ID`. The STUDENT_ID refers to the unique alphanumeric sequence assigned to a person shown in the displayed person list. The student_id **must be 9 digits long
* Only 1 field may be provided.
* Existing value will be updated to the input value.
* Name can be case-insensitive, eg. john doe, JOHN DOE same as John Doe
* Email must have the correct domain (@u.nus.edu) and string length of 8 for the email username eg. [email protected]
* Grade may be of values: [A+, A, A-, B+, B, B-, C+, C, D+, D, F]

Examples:
* `edit 1 p/91234567 e/[email protected]` Edits the phone number and email address of the 1st person to be `91234567` and `[email protected]` respectively.
* `edit 2 n/Betsy Crower t/` Edits the name of the 2nd person to be `Betsy Crower` and clears all existing tags.
* `edit id/A0123456X e/[email protected]` Edits the email address of the person with student_id = A0123456X to be `[email protected]`.
* `edit id/A2233445X n/Betsy Crower` Edits the name of the person with student_id = A2233445X to be `Betsy Crower`.


### Locating persons by name: `find`

Expand Down Expand Up @@ -187,12 +180,10 @@ _Details coming soon ..._

## Command summary

Action | Format, Examples
--------|------------------
**Add** | `add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]…​` <br> e.g., `add n/James Ho p/22224444 e/[email protected] a/123, Clementi Rd, 1234665 t/friend t/colleague`
**Clear** | `clear`
**Delete** | `delete INDEX`<br> e.g., `delete 3`
**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`
**List** | `list`
**Help** | `help`
| Action | Format, Examples |
|------------|--------------------------------------------------------------------------------------------------------------------------|
| **Add** | `add id/STUDENT_ID n/NAME e/EMAIL g/GRADE [t/TAG]​​` <br> e.g., `add id/A01234567X n/James Ho e/[email protected] g/B+` |
| **Delete** | `delete id/STUDENT_ID`<br> e.g., `delete A01234567X` |
| **Edit** | `edit id/STUDENT_ID [g/GRADE] `<br> e.g.,`edit A0123466C g/A+` |
| **View** | `view id/STUDENT_ID`<br> e.g., `find A0123466D` |
| **Group** | `group id/STUDENT_ID_1 [id/STUDENT_ID_2] …` <br> e.g., `group A1234567R, A2345678R` |

0 comments on commit 60bf68d

Please sign in to comment.