Skip to content

Commit

Permalink
Fix UserGuide.md
Browse files Browse the repository at this point in the history
  • Loading branch information
yyyaohhh committed Nov 11, 2023
1 parent 26559ae commit 43a547d
Show file tree
Hide file tree
Showing 2 changed files with 43 additions and 16 deletions.
59 changes: 43 additions & 16 deletions docs/UserGuide.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,27 +37,31 @@ Warnings in boxes like this contain information that are vital to the running of
Provides you with information that is useful to know.
</md></div>

<br>

--------------------------------------------------------------------------------------------------------------------
## Table of Contents

1. [Quick start](#quick-start)
2. [Features](#features)
2.1. [Viewing help](#viewing-help-help)
2.2. [Modules](#modules)
2.2.1. [Adding a module](#adding-a-module-add)
2.2.2. [Editing a module](#editing-a-module-edit)
2.2.3. [Deleting a module](#deleting-a-module-delete)
2.2.4. [Finding information about a module](#finding-information-about-a-module-info)
2.3. [Calculating the total current CAP](#calculating-the-total-current-cap-calculatecap)
2.4. [Calculating the total current Modular Credits (MCs)](#calculating-the-total-current-modular-credits-mcs-calculatemc)
2.5. [Exiting the program](#exiting-the-program-exit)
* [Viewing help](#viewing-help-help)
* [Modules](#modules)
* [Adding a module](#adding-a-module-add)
* [Editing a module](#editing-a-module-edit)
* [Deleting a module](#deleting-a-module-delete)
* [Finding information about a module](#finding-information-about-a-module-info)
* [Calculating the total current CAP](#calculating-the-total-current-cap-calculatecap)
* [Calculating the total current Modular Credits (MCs)](#calculating-the-total-current-modular-credits-mcs-calculatemc)
* [Exiting the program](#exiting-the-program-exit)
3. [Advanced Use](#advanced-use)
3.1. [Editing the data file](#editing-the-data-file)
* [Editing the data file](#editing-the-data-file)
4. [FAQ](#faq)
5. [Known issues](#known-issues)
6. [Command summary](#command-summary)
7. [Glossary](#glossary)

<br>

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

## Quick start
Expand All @@ -74,6 +78,7 @@ Provides you with information that is useful to know.
A GUI similar to below should appear in a few seconds. Note how the app contains some sample data.<br> <br>
![Ui](images/Ui.png)


5. Type the command in the command box and press Enter to execute it. e.g. typing **`help`** and pressing Enter will open the help window.<br>
Some example commands you can try:

Expand All @@ -87,6 +92,8 @@ Provides you with information that is useful to know.

6. You can refer to the [Features](#features) section below for details of each command.

<br>

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

## Features
Expand Down Expand Up @@ -146,14 +153,16 @@ Examples:
The module code, module title, module description and modular credits **cannot** be edited.
</md></div>


In ModCraft, you can specify the **year, semester and grade** of each module when you are adding or editing your study plan.


<div class="alert alert-primary"><md>:bulb: **Tip:**

The parameter for Year follows a constraint of `0` to `6`, where Year 0 represents the Advance Placement semester.
* The parameter for Year follows a constraint of `0` to `6`, where Year 0 represents the Advance Placement semester.
There is **only one** Advance Placement semester and whenever `y/0` is entered, regardless of the semester entered, the module will be added or edited to the Advance Placement Semester.

The list for the Advance Placement semester and Special Terms 1 and 2 (ST) will only be displayed when there is a module within them.
* The list for the Advance Placement semester and Special Terms 1 and 2 (ST) will only be displayed when there is a module within them.

</md></div>

Expand All @@ -164,13 +173,15 @@ Below shows what ModCraft should look like for adding a module the Advance Place
<img src="images/ImagesForUG/ap-after.png" alt="After executing add command" style="height:400px; margin:20px;">
</div>


Below shows what ModCraft should look like for adding a module to the Special Term (ST). The module `CS3230` is being added to Year 1, special term 1.

<div style="display:flex; justify-content:space-around; align-items:center;">
<img src="images/ImagesForUG/st-before.png" alt="Before executing add command" style="height:400px; margin:20px;">
<img src="images/ImagesForUG/st-after.png" alt="After executing add command" style="height:400px; margin:20px;">
</div>


<div class="alert alert-warning"><md>:exclamation: **Caution:**

Currently, ModCraft have certain **limitations**.
Expand Down Expand Up @@ -205,10 +216,12 @@ Below shows what ModCraft should look like for executing the `add` command.
<img src="images/ImagesForUG/add-after.png" alt="After executing add command" style="height:400px; margin:20px;">
</div>


<div class="alert alert-primary"><md>:bulb: **Tip:**
TTo **plan ahead** using ModCraft, you can input `IP` for grade to represent grade **in progress**.

For **Satisfactory/Unsatisfactory (S/U)** modules, you can insert `S` or `U` as `GRADE`.
* To **plan ahead** using ModCraft, you can input `IP` for grade to represent grade **in progress**.

* For **Satisfactory/Unsatisfactory (S/U)** modules, you can insert `S` or `U` as `GRADE`.
</md></div>

<br>
Expand Down Expand Up @@ -256,9 +269,10 @@ Below shows what ModCraft should look like for executing the `delete` command. T
</div>

<div class="alert alert-default" style="background-color: rgb(223, 240, 216); border-color: rgb(214, 233, 198);"><md>:information_source: **Note:**
If you are **dropping a module** and retaking it in later semesters, the module dropped should be **deleted** before adding the same module to another semester later on.

ModCraft currently **does not support** retaking failed modules by keeping the failed module in the study plan and adding another copy of the same module for retake.
* If you are **dropping a module** and retaking it in later semesters, the module dropped should be **deleted** before adding the same module to another semester later on.

* ModCraft currently **does not support** retaking failed modules by keeping the failed module in the study plan and adding another copy of the same module for retake.
</md></div>

<div class="alert alert-warning"><md>:exclamation: **Caution:**
Expand Down Expand Up @@ -308,6 +322,7 @@ Below shows what ModCraft should look like for executing the `calculateCAP` comm
<img src="images/ImagesForUG/cap-after.png" alt="After executing calculateCAP command" style="height:400px; margin:20px;">
</div>


<div class="alert alert-primary"><md>:bulb: **Tip:**

The result displayed by the `calculateCAP` command **does not include** the modules with grades marked as `IP` (In progress), `CS` and `CU`.
Expand Down Expand Up @@ -345,6 +360,8 @@ Format: `exit`

<br>

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

## Advanced use

ModuleList data is saved in the hard disk automatically after any command you inputted that changes the data.
Expand All @@ -358,9 +375,13 @@ The module data is saved automatically as a JSON file `[JAR file location]/data/

Advanced users are welcome to update data directly by editing that data file.
<div class="alert alert-warning"><md>:exclamation: **Caution:**

If your changes to the data file makes its format invalid, ModCraft will discard all data and start with a default data file at the next run. Hence, it is recommended to take a backup of the file before editing it.

</md></div>

<br>

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

## FAQ
Expand All @@ -372,12 +393,16 @@ If your changes to the data file makes its format invalid, ModCraft will discard
**A**: The data is saved in the hard disk automatically after any command that changes the data.
There is no need to save manually.

<br>

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

## Known issues

1. **When using multiple screens**, 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.

<br>

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

## Command summary
Expand All @@ -394,6 +419,8 @@ There is no need to save manually.

<br>

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

## Glossary

- Command Line Interface: A display that allows you to type commands to interact with the application.
Expand Down
Binary file modified docs/images/Ui.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 43a547d

Please sign in to comment.