Skip to content

Commit 8bd9535

Browse files
authored
Merge pull request AY2324S2-CS2103T-F13-1#275 from ForAeons/ug-improve-faq
docs: improve ug with FAQ and update keywords
2 parents 2b11168 + c548bc7 commit 8bd9535

File tree

1 file changed

+65
-73
lines changed

1 file changed

+65
-73
lines changed

docs/UserGuide.md

+65-73
Original file line numberDiff line numberDiff line change
@@ -61,57 +61,57 @@ Diving into TAPro, you'll encounter some handy notations and terms. We've decode
6161

6262
### Symbols
6363

64-
| Symbol | Meaning |
65-
|------------------------------------------------------|--------------------------------------------------------|
66-
| <i class="fa-solid fa-lightbulb text-success"></i> | Tip |
67-
| <i class="fa-solid fa-exclamation text-warning"></i> | Warning |
68-
| <i class="fa-solid fa-flag text-danger"></i> | Important |
69-
| <i class="fa-solid fa-info text-info"></i> | Additional useful information |
70-
| <i class="fa-solid fa-check text-success"></i> | Valid Example |
71-
| <i class="fa-solid fa-x text-danger"></i> | Invalid Example |
72-
| <i class="fa-solid fa-exclamation text-danger"></i> | Danger |
73-
| <i class="fa-solid fa-book text-primary"></i> | Definition |
74-
| <i class="fa-solid fa-question text-info"></i> | Question |
75-
| **`UPPER_CASE`** | Represents parameters that need to be given by you! |
64+
| Symbol | Meaning |
65+
|------------------------------------------------------|-----------------------------------------------------------------|
66+
| <i class="fa-solid fa-lightbulb text-success"></i> | Tip |
67+
| <i class="fa-solid fa-exclamation text-warning"></i> | Warning |
68+
| <i class="fa-solid fa-flag text-danger"></i> | Important |
69+
| <i class="fa-solid fa-info text-info"></i> | Additional useful information |
70+
| <i class="fa-solid fa-check text-success"></i> | Valid Example |
71+
| <i class="fa-solid fa-x text-danger"></i> | Invalid Example |
72+
| <i class="fa-solid fa-exclamation text-danger"></i> | Danger |
73+
| <i class="fa-solid fa-book text-primary"></i> | Definition |
74+
| <i class="fa-solid fa-question text-info"></i> | Question |
75+
| **`UPPER_CASE`** | Represents parameters that need to be given by you! |
7676
| **... (Ellipsis)** | Indicates that a parameter can be repeated or omitted entirely. |
77-
| **[Square Brackets]** | Denotes optional parameters. |
77+
| **[Square Brackets]** | Denotes optional parameters. |
7878

7979
### Keywords
8080

81-
| Keywords | Meaning |
82-
|------------------------------------|------------------------------------------------------------------------------------------|
83-
| **Command Line Interface** | A text-based interface used for entering commands directly. |
84-
| **Graphical User Interface** | The visual interface that enhances user interaction with graphical elements. |
85-
| **Parameters** | Specific pieces of information required by commands to execute a function. |
86-
| **Attribute** | A single detail of a student. |
87-
| **INDEX** | A case-insensitive, unique identification code assigned to each student. |
88-
| **NUSNET** | A unique identification code assigned to each student. |
89-
| **TAG** | A one-word, case-insensitive, label that can be associated with a student for categorization. |
90-
| **Autocomplete** | A feature that predicts and completes commands as you type. |
91-
| **Command History** | A record of successfully executed commands that can be retrieved for reuse. |
81+
| Keywords | Meaning |
82+
|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
83+
| **Command Line Interface** | A text-based interface used for entering commands directly. |
84+
| **Graphical User Interface** | The visual interface that enhances user interaction with graphical elements. |
85+
| **Parameters** | Specific pieces of information required by commands to execute a function. |
86+
| **Attribute** | A single detail of a student. |
87+
| **INDEX** | A case-insensitive, unique identification code assigned to each student. |
88+
| **NUSNET** | A unique identification code assigned to each student. |
89+
| **TAG** | A one-word, non-space separated, case-insensitive, alphanumeric label that can be associated with a student for categorization. For example `bestFriend4Ever`, `colleague`, `Club` are valid tags, but `best friend`, `best-friend` are not valid tags. |
90+
| **Autocomplete** | A feature that predicts and completes commands as you type. |
91+
| **Command History** | A record of successfully executed commands that can be retrieved for reuse. |
9292

9393
### Abbreviations
9494

95-
| Abbreviation | Meaning |
96-
|-------------|-------------------------------------------------------------------------|
97-
| **ASCII** | American Standard Code for Information Interchange |
98-
| **GUI** | Graphical User Interface |
99-
| **CLI** | Command Line Interface |
100-
| **TA** | Teaching Assistant |
101-
| **CS** | Computer Science |
102-
| **NUS** | National University of Singapore |
103-
| **URL** | Uniform Resource Locator |
104-
| **JSON** | JavaScript Object Notation |
95+
| Abbreviation | Meaning |
96+
|--------------|----------------------------------------------------|
97+
| **ASCII** | American Standard Code for Information Interchange |
98+
| **GUI** | Graphical User Interface |
99+
| **CLI** | Command Line Interface |
100+
| **TA** | Teaching Assistant |
101+
| **CS** | Computer Science |
102+
| **NUS** | National University of Singapore |
103+
| **URL** | Uniform Resource Locator |
104+
| **JSON** | JavaScript Object Notation |
105105

106106
### Recognised Prefixes for Attributes
107-
| Prefix | Attribute |
108-
|--------|-----------------------------|
109-
| **n/** | Name of the student |
110-
| **nn/** | NUSNet ID of the student |
111-
| **p/** | Phone number of the student |
112-
| **e/** | Email of the student |
113-
| **m/** | Major of the student |
114-
| **t/** | Tag of the student |
107+
| Prefix | Attribute |
108+
|---------|-----------------------------|
109+
| **n/** | Name of the student |
110+
| **nn/** | NUSNet ID of the student |
111+
| **p/** | Phone number of the student |
112+
| **e/** | Email of the student |
113+
| **m/** | Major of the student |
114+
| **t/** | Tag of the student |
115115
| **wk/** | Week number for attendance |
116116

117117
This segment aims to make your TAPro experience as smooth as silk. With these notions and terms at your fingertips, you're well on your way to becoming a TAPro power user!
@@ -164,7 +164,7 @@ A GUI similar to the below image should appear in a few seconds. Note how the ap
164164

165165
* `addstu nn/E0952224 n/John Doe p/98765432 e/johnd@example.com m/Computer Science` : Adds a student named `John Doe` to the contact book.
166166

167-
* `delstu nn/NUSNET_ID` : Deletes the student with the specified `NUSNET_ID` from the contact book.
167+
* `delstu nn/NUSNET` : Deletes the student with the specified `NUSNET` from the contact book.
168168

169169
* `clear` : Deletes all students, and their contact and attendance information.
170170

@@ -324,23 +324,13 @@ Format: `addstu n/NAME nn/NUSNET [p/PHONE] [e/EMAIL] [m/MAJOR] [t/TAG]…​`
324324

325325
<box type="info" light>
326326

327-
**Note:** NUSNet provided will be converted to uppercase automatically upon running the command. (e.g., `e0123456` will be converted to `E0123456`)
328-
</box>
329-
330-
<box type="info" light>
331-
332-
**Note:** Tags must be a single, non-space separated, alphanumeric word. For example `bestFriend4Ever`, `colleague`, `Club` are valid tags, but `best friend`, `best-friend` are not valid tags.
333-
</box>
334-
335-
<box type="warning" light>
336-
337-
**Note:** The application will not wrap the text in the various fields. By [international standards](https://en.wikipedia.org/wiki/E.164), telephone numbers should not exceed 15 digits. And long names and email addresses are extremely rare, which falls outside of normal use cases. Lastly, most students will have no more than 2 majors.
327+
**Note:** NUSNet ID is case-insensitive, and it will be converted to uppercase automatically upon running the command. (e.g., `e0123456` will be converted to `E0123456`)
338328
</box>
339329

340330
Examples:
341-
* `addstu n/John Doe nn/e1234567 p/98765432 e/johnd@example.com m/Computer Science`
342-
* `addstu n/Betsy Crowe nn/e0123456 t/friend e/betsycrowe@example.com m/Mathematics, Physics p/1234567 t/club`
343-
* `addstu n/Betsy Crowe nn/e0123456`
331+
* `addstu n/John Doe nn/E1234567 p/98765432 e/johnd@example.com m/Computer Science`
332+
* `addstu n/Betsy Crowe nn/E0123456 t/friend e/betsycrowe@example.com m/Mathematics, Physics p/1234567 t/club`
333+
* `addstu n/Betsy Crowe nn/E0123456`
344334

345335
<markdown class="d-print-none">---</markdown>
346336
<div style="page-break-after: always;"></div>
@@ -362,7 +352,7 @@ If there are additional arguments behind `list` we will simply ignore them.
362352

363353
Edits an existing person in the contact book.
364354

365-
Format: `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [m/MAJOR] [nn/NUSNET_ID] [t/TAG]…​`
355+
Format: `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [m/MAJOR] [nn/NUSNET] [t/TAG]…​`
366356

367357
* 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, …​
368358
* At least one of the optional fields must be provided.
@@ -376,7 +366,7 @@ Examples:
376366
* `edit 2 n/Betsy Crower t/` Edits the name of the 2nd person to be `Betsy Crower` and clears all existing tags.
377367

378368
<box type="info" light>
379-
This command differs from most other commands that use the `NUSNET_ID` to identify a student. This command uses the index number shown in the displayed person list to identify the student to be edited.
369+
This command differs from most other commands that use the `NUSNET` to identify a student. This command uses the index number shown in the displayed person list to identify the student to be edited.
380370
</box>
381371

382372
<markdown class="d-print-none">---</markdown>
@@ -465,7 +455,7 @@ Format: `find KEYWORD [MORE_KEYWORDS]…​`
465455

466456
Marks a student's attendance for a particular week.
467457

468-
Format: `mark nn/NUSNET_ID wk/WEEK_NUMBER`
458+
Format: `mark nn/NUSNET wk/WEEK_NUMBER`
469459

470460
Example:
471461
* `mark nn/E1234567 wk/3`
@@ -477,7 +467,7 @@ Example:
477467

478468
Unmarks a student's attendance for a particular week.
479469

480-
Format: `unmark nn/NUSNET_ID wk/WEEK_NUMBER`
470+
Format: `unmark nn/NUSNET wk/WEEK_NUMBER`
481471

482472
Example:
483473
* `unmark nn/E1234567 wk/3`
@@ -490,15 +480,15 @@ Example:
490480

491481
Deletes the specified student from the contact book.
492482

493-
Format: `delstu nn/NUSNET_ID`
483+
Format: `delstu nn/NUSNET`
494484

495485
* Deletes the student with the specified NUSNet ID from the contact book.
496486

497487
Examples:
498488
* `delstu nn/E0957499` deletes the student with the NUSNet ID of `E0957499` in the contact book.
499489

500490
Pro Tip:
501-
* If you cannot remember your student's NUSNet ID, you could use `find Betsy` or `list` followed by `delstu nn/<Betsy's NUSNET_ID>` to find and delete the student.
491+
* If you cannot remember your student's NUSNet ID, you could use `find Betsy` or `list` followed by `delstu nn/<Betsy's NUSNET>` to find and delete the student.
502492

503493
<markdown class="d-print-none">---</markdown>
504494
<div style="page-break-after: always;"></div>
@@ -834,6 +824,12 @@ Do also note that tags are alphanumeric and cannot contain spaces or special cha
834824
</box>
835825
</box>
836826
827+
<box type="info" icon=":fa-solid-question:" light>
828+
829+
**Q:** Long names, phone numbers, emails and majors are truncated in the UI. Why does TAPro not make these text wrap around?<br/>
830+
**A:** By [international standards](https://en.wikipedia.org/wiki/E.164), telephone numbers should not exceed 15 digits. And typical names and email addresses are rarely too long, which falls outside of normal use cases. Lastly, most students will have no more than 2 majors. So under any normal use case, the fields will not contain texts long enough to be truncated. Having a single line of text for each field also ensures the UI remains clean and uncluttered.
831+
</box>
832+
837833
838834
### Saving More Time
839835
<box type="info" icon=":fa-solid-question:" light>
@@ -877,7 +873,7 @@ the front of the command.
877873
If you move the application to a secondary screen, and later switch to using only the primary screen, the GUI will open off-screen. The remedy is to delete the `preferences.json` file created by the application before running the application again.
878874
</box>
879875

880-
<box type="warning" theme="danger" seamless>
876+
<box type="warning" theme="danger" light>
881877

882878
**2. If you have more than one copy of TAPro running**
883879

@@ -888,20 +884,16 @@ If you have more than one copy of TAPro running, the application may not functio
888884
889885
## <i class="fa-solid fa-table-list"></i> Command summary
890886
891-
892-
## Command summary
893-
894887
| Action | Format, Examples |
895888
|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
896-
| **Add Student** | `addstu n/NAME p/PHONE_NUMBER e/EMAIL nn/NUSNET_ID m/MAJOR [t/TAG]…​` <br> e.g., `add n/James Ho p/22224444 e/jamesho@example.com nn/e1234567 m/Computer Science t/friend t/colleague` |
889+
| **Add Student** | `addstu n/NAME p/PHONE_NUMBER e/EMAIL nn/NUSNET m/MAJOR [t/TAG]…​` <br> e.g., `addstu n/James Ho p/22224444 e/jamesho@example.com nn/E1234567 m/Computer Science t/friend t/colleague` |
897890
| **Clear** | `clear` |
898-
| **Delete Student** | `delstu nn/NUSNET_ID`<br> e.g., `delstu nn/e0957499` |
891+
| **Delete Student** | `delstu nn/NUSNET`<br> e.g., `delstu nn/E0957499` |
899892
| **Edit** | `edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [m/MAJOR] [t/TAG]…​`<br> e.g.,`edit 2 n/James Lee e/jameslee@example.com` |
900-
| **Mark** | `mark nn/NUSNET_ID wk/WEEK_NUMBER`<br> e.g., `mark nn/e1234567 wk/3` |
901-
| **Unmark** | `unmark nn/NUSNET_ID wk/WEEK_NUMBER`<br> e.g., `unmark nn/e1234567 wk/3` |
902-
| **Find** | `find KEYWORD [MORE_KEYWORDS]`<br> e.g., `find James Jake` |
893+
| **Mark** | `mark nn/NUSNET wk/WEEK_NUMBER`<br> e.g., `mark nn/E1234567 wk/3` |
894+
| **Unmark** | `unmark nn/NUSNET wk/WEEK_NUMBER`<br> e.g., `unmark nn/E1234567 wk/3` |
895+
| **Find** | `find KEYWORD [MORE_KEYWORDS]…​`<br> e.g., `find James Jake` |
903896
| **Set Course** | `setcrs COURSE_CODE` |
904897
| **List** | `list` |
905898
| **Help** | `help` |
906899
| **Exit** | `exit` |
907-

0 commit comments

Comments
 (0)