Skip to content

Commit

Permalink
Pull from upstream
Browse files Browse the repository at this point in the history
  • Loading branch information
ketweeen committed Nov 15, 2023
2 parents 51abb05 + cd7c1f8 commit 96518d3
Showing 1 changed file with 43 additions and 35 deletions.
78 changes: 43 additions & 35 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,12 +127,14 @@ You are an **advanced** user if ...

**Notes** and **tips** curated for you are labeled by the following box!

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>



<br>

**Also, take note of the following icons and their meanings.**

<box type="warning" seamless>
Expand Down Expand Up @@ -337,8 +339,8 @@ Format: `create t/CATEGORY TAGNAME…​`
* You can view all of your tags by keying in the `listT` command.
</box>

An example of the `create` command being successfully executed:
1. Enter the command `create t/dept finance t/role accountant`
**An example of the `create` command being successfully executed:**
1. Enter the command `create t/dept marketing t/role developer`
2. This is what you should see upon successful execution of command.

![create-success](images/create-success.png)
Expand All @@ -351,7 +353,7 @@ An example of the `create` command being successfully executed:

| Reason for Error | Error Message | Remedy / Suggested course of action |
|-------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
| Missing create keyword: `create` | Unknown command | Follow the command format of `create t/CATEGORY TAGNAME…​` closely. |
| Missing create keyword: `create` | Unknown command | Follow the command format of `create t/CATEGORY TAGNAME…​` closely |
| Missing mandatory field e.g. `create` | Invalid command format! | Ensure that you specify at least one tag category and tag name of the tag you would like to create. |
| Incomplete field e.g. `create t/test` | Invalid command format! | Ensure that both parts of the field are included i.e. specify both tag category and tag name. |
| Invalid tag name e.g. `create t/developer@` | Tags names should be alphanumeric. | Ensure that the tag name does not contain any non-alphanumeric characters i.e. no symbols and whitespaces. |
Expand Down Expand Up @@ -416,7 +418,7 @@ Format: `add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/[CATEGORY] TAGNAME]…
* An applicant can have any number of tags (including 0)!
</box>

An example of the `add` command being successfully executed:
**An example of the `add` command being successfully executed:**
1. Enter the command `add n/Betsy Crowe t/friend e/[email protected] a/Newgate Prison p/1234567 t/dept finance`
2. This is the result of the successful `add` command (Take note that command entered will not be shown in the result):

Expand Down Expand Up @@ -456,15 +458,15 @@ Format: `remark INDEX r/REMARK`

<div style="page-break-after: always;"></div>

An example of the `remark` command being successfully executed:
**An example of the `remark` command being successfully executed:**
1. Enter the command `remark 1 r/Great attitude, hardworking`
2. This is the result of the successful `remark` command (Take note that command entered will not be shown in the result):
![Remark-Success](images/remark-command-success.png)
<br>

<div style="page-break-after: always;"></div>

An example of the `remark` command being successfully executed with the **REMARK** keyword:
**An example of the `remark` command being successfully executed with the **REMARK** keyword:**
1. Enter the command `remark 1 r/**REMARK** furthermore he is great at teamwork`
2. This is the result of the successful `remark` command (Take note that command entered will not be shown in the result):
![Remark-Success](images/remark-command-enhanced-success.png)
Expand All @@ -479,7 +481,7 @@ An example of the `remark` command being successfully executed with the **REMARK
| Invalid Index | The person index provided is invalid | Ensure that the index is valid. That is it is a number that is on the displayed applicant list. |
| Negative or 0 Index | Invalid command format! | Ensure that the index is a positive integer and is also a number that is on the displayed applicant list. |

Additional Examples:
**Additional Examples:**
* `remark 1` Empties the remark of the 1st applicant. It is equivalent to `remark 1 r/`.

[Jump back to Table of Contents](#table-of-contents)
Expand Down Expand Up @@ -578,7 +580,7 @@ Format: `set INDEX STATUS`
| Mandatory | `INDEX` | `INDEX` must be an existing index in the displayed applicant list and it must not be greater than the total number of applicant in JABPro. It must also be a positive integer |
| Mandatory | `STATUS` | `STATUS` must be one of the following - "Preliminary", "Interviewed", "Rejected", "Accepted". It is case-insensitive. |

Examples:
**Examples:**
* `list` followed by `set 2 Interviewed` sets the 2nd applicant in the address book to "Interviewed".

[Jump back to Table of Contents](#table-of-contents)
Expand All @@ -605,14 +607,14 @@ This means that the view will be updated to reflect the latest changes to the da

</box>

An example of the `view` command being successfully executed:
**An example of the `view` command being successfully executed:**
1. Enter the command `view 3`
2. This is the result of the successful `view` command (Take note that command entered will not be shown in the result):

![View-Success](images/view-command-success.png)
<br>

An example of the `view` command bei\ng successfully executed for applicant with tags and score:
**An example of the `view` command being successfully executed for applicant with tags and score:**
1. Enter the command `view 2` (**Applicant with tags and score**)
2. This is the result of the successful `view` command (Take note that command entered will not be shown in the result):

Expand Down Expand Up @@ -666,10 +668,11 @@ Format: `edit INDEX ([n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [t/TAGNAME]…​
* If you used a tag that has not been created using `create` in an `edit` command, the tag would still be added to the applicant, but it would be _uncategorized_.
* If you have **multiple tags in different categories with the same name**, you must **specify the category** when you want to tag the specified applicant with one of these tags e.g. `edit INDEX t/CATEGORY DUPLICATETAGNAME`

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


* If you still would like to tag an applicant that has **not** been created, but you do not want this tag to be _uncategorized_, you can do so by doing
`edit INDEX t/CATEGORY TAGNAME`.

Expand All @@ -689,10 +692,11 @@ This is because, `create` only creates **new** categorized tags. It does **not**
* You can only edit the score of an applicant i.e. `edit INDEX sc/TAGNAME SCORE` if they have been tagged with the assessment-related `TAGNAME`.


<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


* You can also tag the applicant and edit their score **at the same time** by doing `edit INDEX t/TAGNAME sc/TAGNAME SCORE`.
* Note that the tag has to have already been created using `create` with the category `assessment`. You **cannot** do this with a tag that hasn't been created even if you specified its category _assessment_ i.e. `edit INDEX t/assessment interview1 sc/interview1 100` does **NOT**
work. This is because, you cannot create tag and edit score at the same time as editing score relies on the fact that the tag has already existed.
Expand All @@ -712,7 +716,7 @@ Nonetheless, we **strongly recommend you to use `create` to create categorized t

<div style="page-break-after: always;"></div>

An example of the `edit` command being successfully executed:
**An example of the `edit` command being successfully executed:**
1. Enter the command `edit 1 n/Alex Ho p/91234567` (**edits name and phone number**)
2. This is the result of the successful `edit` command (Take note that command entered will not be shown in the result):

Expand All @@ -721,7 +725,7 @@ An example of the `edit` command being successfully executed:

<div style="page-break-after: always;"></div>

An example of the `edit` command being successfully executed with tags and score:
**An example of the `edit` command being successfully executed with tags and score:**
1. Ensure that you have created a tag `Interview` under the `assessment` category using the `create` command. Enter the command `create t/assessment Interview`
2. Enter the command `edit 1 t/Interview sc/Interview 80` (**edits tag and score**)
3. This is the result of the successful `edit` command (Take note that command entered will not be shown in the result):
Expand All @@ -731,7 +735,7 @@ An example of the `edit` command being successfully executed with tags and score

<div style="page-break-after: always;"></div>

An example of the `edit` command being successfully executed to clear a tags and score:
**An example of the `edit` command being successfully executed to clear a tags and score:**
1. Enter the command `edit 1 t/` (**Clear all tags**)
2. This is the result of the successful `edit` command (Take note that command entered will not be shown in the result):

Expand Down Expand Up @@ -787,14 +791,15 @@ Format: `delete (t/TAGNAME... st/STATUS...)`
* Multiple delete parameters for a specific category are divided by spaces (not commas!) i.e. `delete st/preliminary interviewed`
* Delete parameters are case-insensitive i.e. doing `delete t/interN` is the same as `delete t/intern`

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


**Note:**
* You can combine multiple delete categories in a single `delete` command e.g. `delete st/interviewed t/intern`

An example of **delete by index** command being successfully executed:
**An example of **delete by index** command being successfully executed:**
1. Enter the command `delete Bernice`

![delete-by-index-pre](images/delete-by-index-pre.png)
Expand All @@ -810,14 +815,14 @@ Assuming this as the data after executing `list`:

1. `delete t/marketing software`

![delete-by-tags-status-1](images/delete-by-tags-status-1.png)
![delete-by-tags-status-pre](images/delete-by-tags-status-1.png)

The above `delete` command deleted all applicants whose tags match ANY of the given keywords. This is because
`delete` does an `OR` search **within a specific category**. <br>

2. `delete st/interviewed t/software`

![delete-by-tags-status-2](images/delete-by-tags-status-2.png)
![delete-by-tags-status-pre](images/delete-by-tags-status-2.png)

The above `delete` command only deleted Bernice because `delete` does an `AND` search **across multiple categories**.<br>

Expand Down Expand Up @@ -856,7 +861,7 @@ It's best to explain this by breaking down an example `delete` command! <br>

Finds job applicants whose profiles match the specified categories' keywords. The search categories are: name, status, tag.

Format: `search (n/NAME... st/STATUS... t/TAGNAME...)`
Format: `search (n/NAME... st/STATUS... t/TAGNAME...)`

| Type | Field | Constraints |
|------------|-------------|---------------------------------------------------------------------------------------------|
Expand All @@ -872,14 +877,15 @@ Format: `search (n/NAME... st/STATUS... t/TAGNAME...)`
* Multiple search parameters for a specific category are divided by spaces (not commas!) i.e. `search st/preliminary interviewed`
* Search parameters are case-insensitive i.e. doing `search n/aLeX` is the same as `search n/alex`

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


**Note:**
* You can combine multiple search categories in a single `search` command e.g. `search n/alex st/interviewed t/intern`

Here are some examples of **search** command being successfully executed:
**Here are some examples of **search** command being successfully executed:**
1. Enter `search n/alex bernice`

![search-success-1](images/search-success-1.png)
Expand Down Expand Up @@ -976,7 +982,7 @@ Set up for examples when you first start JABPro with default data:

<div style="page-break-after: always;"></div>

An example of the `filter` command being successfully executed:
**An example of the `filter` command being successfully executed:**
1. Enter the command `list`
2. Enter the command `filter t/interview met/percentile val/80` (**Filter by percentile**)
3. This is the result of the successful `filter` command (Take note that command entered will not be shown in the result):
Expand All @@ -986,7 +992,7 @@ An example of the `filter` command being successfully executed:

<div style="page-break-after: always;"></div>

An example of the `filter` command being successfully executed with `median`:
**An example of the `filter` command being successfully executed with `median`:**
1. Enter the command `list`
2. Enter the command `filter t/interview met/median` (**Filter by median**)
3. This is the result of the successful `filter` command (Take note that command entered will not be shown in the result):
Expand Down Expand Up @@ -1130,7 +1136,7 @@ Exports the entries into a .csv file located in the current directory as (/data/
* JABPro must have write permissions, this means that if the .csv file is open,
exporting again will not be possible.

Examples:
**Examples:**
* `export` exports the data to /data/export.csv

[Jump back to Table of Contents](#table-of-contents)
Expand Down Expand Up @@ -1166,10 +1172,11 @@ Format: `exit`
## Additional information
<a name="additional-information"></a>

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


### Summary Statistics

Summary Statistics is a table generated by JABPro that displays the following information about an applicant:
Expand Down Expand Up @@ -1204,10 +1211,11 @@ You should ensure that you have **sufficient candidates of more than 20** with a
3. `percentile` as where this applicant stands among all other applicants (treat it like a ranking system, the higher the percentile, the better the applicant is performing)
</box>

<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 70px; height: 20px; text-align: center;">
<p style="color: #FFFFFF; font-size: 15px; font-weight: bold; font-family: 'Your Font Name', sans-serif;">Advanced</p>
<div style="display: flex; justify-content: center; align-items: center; background-color: #FF0000; padding: 10px; border-radius: 30px; width: 100px; height: 35px; text-align: center;">
<p style="color: #FFFFFF; font-size: 18px; font-weight: bold;>Advanced</p>
</div>


**Note**:
* Understand that `percentile` has limited functionality in some context. This is because if two applicants have the same score, they are `rank` the same. This means that the percentile of both applicants will be the same.
* If all applicants have the same score, their percentile will all be 0.0. This is because they are all `rank` the same.
Expand Down

0 comments on commit 96518d3

Please sign in to comment.