Skip to content

Commit be008fe

Browse files
committed
More UG enhancements
1 parent 45d3faa commit be008fe

File tree

1 file changed

+59
-51
lines changed

1 file changed

+59
-51
lines changed

docs/UserGuide.md

Lines changed: 59 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -106,31 +106,32 @@ Common mistakes:
106106
Throughout this guide, there might be some terms that you might not be familiar with, and that's fine.
107107
Here's a table of some technical terms you'll see further in the guide:
108108

109-
| Term | Definition |
110-
|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
111-
| **Java** | A programming language. Various versions can be downloaded from [here](https://www.oracle.com/sg/java/technologies/downloads/). |
112-
| **home folder** | The main folder where all app activity can take place and files can be stored |
113-
| **command terminal** | A text-based interface to your computer.<br>On Windows, this can be opened by pressing the Windows key, and searching for an app called "Command Prompt".<br> On iOS, this can be opened by pressing Command + Space, typing in "terminal", then pressing "Return". |
114-
| `cd` | A Linux (operating system) command used to navigate to different folders in your command terminal. Stands for "change directory".<br>Linux tutorials can be found [here](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview). |
115-
| **GUI** | Short for "Graphical User Interface". The digital interface in which user interact with graphical components, such as icons and buttons. |
116-
| **CLI** | Short for "Command Line Interface". A software mechanism you use to interact with the application using your keyboard. |
109+
| Term | Definition |
110+
|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
111+
| **Java** | A programming language. Various versions can be downloaded from [here](https://www.oracle.com/sg/java/technologies/downloads/). |
112+
| **home folder** | The main folder where all app activity can take place and files can be stored |
113+
| **command terminal** | A text-based interface to your computer.<br>On Windows, this can be opened by pressing the Windows key, and searching for an app called "Command Prompt".<br> On MacOS, this can be opened by pressing Command + Space, typing in "terminal", then pressing "Return". |
114+
| `cd` | A Linux (operating system) command used to navigate to different folders in your command terminal. Stands for "change directory".<br>Linux tutorials can be found [here](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview). |
115+
| **GUI** | Short for "Graphical User Interface". The digital interface in which user interact with graphical components, such as icons and buttons. |
116+
| **CLI** | Short for "Command Line Interface". A software mechanism you use to interact with the application using your keyboard. |
117117

118118
-----------------------------------------------------------------
119119

120120
## Product Information
121121

122-
ImmuniMate is a desktop application for healthcare professionals and staff to better store and manage their patients' personal and medical information.
122+
ImmuniMate is a **desktop application** for healthcare professionals and staff to better store and manage their patients' personal and medical information.
123123
It is optimised for a single user on a single computer, meaning that after downloading a copy on your computer and using it, your copy cannot be accessed through other computers over the Internet.
124124

125-
ImmuniMate is compatible with Windows, Linux and MacOS operating systems, and installation does not require any additional installers.
125+
ImmuniMate is compatible with **Windows, Linux and MacOS** operating systems, and installation does not require any additional installers.
126126
It has an eye-catching GUI to capture your attention, but despite that, all interactions with ImmuniMate happen through the command line interface (CLI).
127127
This means each feature of ImmuniMate is only accessible through typing a command into the command box in its specified format, and pressing "Enter" to get a response.
128128

129129
Here is a graphic on components of the GUI and their functions:
130130
<br>
131131
<br>
132132
<img src="images/GUIDetailed.png" alt="help message" width="800"/>
133-
133+
<br>
134+
<br>
134135
The list of commands and their formats are specified below:
135136

136137
### Command summary
@@ -151,7 +152,8 @@ The list of commands and their formats are specified below:
151152
| **[Help](#viewing-help-help)** | `help` |
152153
| **[Exit](#exiting-the-program-exit)** | `exit` |
153154

154-
155+
<br>
156+
<br>
155157
The list of fields and their formats are specified below:
156158

157159
### Field summary
@@ -175,7 +177,7 @@ The list of fields and their formats are specified below:
175177
| **Diagnosis** | `d/` | Any text. Blank or empty text is not accepted. | No |
176178
| **Date of visit** | `dov/` | `yyyy-MM-dd` format. | No |
177179

178-
## Error Messages
180+
### Error Messages
179181

180182
Sometimes, **you might type in commands in the wrong format**, or fields that don't make sense, and that's fine.
181183
When that happens, the erroneous command you typed will light up in red, while more details on the nature of the error will be shown in the feedback box, like in the picture below.
@@ -196,34 +198,34 @@ Find retyping commands a hassle? Use your 'Up' and 'Down' arrow keys to access y
196198

197199
1. Ensure you have Java `11` or above installed in your computer.<br>
198200

199-
<div markdown="block" class="alert alert-success">
200-
201-
**:bulb: Tip:**<br>
202-
Don't worry if you don't have Java 11 installed yet!
203-
The Java Development Kit (kind of like an installer) can be downloaded from [here](https://www.oracle.com/sg/java/technologies/downloads/#java11).
204-
Take great care in downloading the one which suits your operating system (Linux, Windows, MacOS etc).
205-
</div>
201+
<div markdown="block" class="alert alert-success">
202+
203+
**:bulb: Tip:**<br>
204+
Don't worry if you don't have Java 11 installed yet!
205+
The Java Development Kit (kind of like an installer) can be downloaded from [here](https://www.oracle.com/sg/java/technologies/downloads/#java11).
206+
Take great care in downloading the one which suits your operating system (Linux, Windows, MacOS etc).
207+
</div>
206208

207-
![Java website](images/JavaWebsite.png)
209+
![Java website](images/JavaWebsite.png)
208210

209211
2. Download the latest `immuniMate.jar` from [our website](https://github.com/AY2324S2-CS2103T-T08-1/tp/releases).
210212

211-
<img src="images/GithubReleasePage.png" alt="help message" width="500"/>
213+
<img src="images/GithubReleasePage.png" alt="help message" width="500"/>
212214

213215
3. Copy the file to the folder you want to use as the _home folder_ for your ImmuniMate.
214216

215217
4. Open a command terminal, and `cd` into the folder you put the jar file in.<br>
216218

217-
<div markdown="block" class="alert alert-success">
218-
219-
**:bulb: Tip:**<br>
220-
`cd` is a Linux command. New to Linux? You can learn the basics fast from [here](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview).
221-
</div>
219+
<div markdown="block" class="alert alert-success">
220+
221+
**:bulb: Tip:**<br>
222+
`cd` is a Linux command. New to Linux? You can learn the basics fast from [here](https://ubuntu.com/tutorials/command-line-for-beginners#1-overview).
223+
</div>
222224

223225
5. Type `java -jar immuniMate.jar` and press "Enter" to run the application.<br>
224226
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data. The colored circle on the right of each patient's name is the status indicator. For more information about the status indicator, see [create](#creating-a-patient-profile-create).<br>
225227

226-
![Ui](images/GUI.png)
228+
![Ui](images/GUI.png)
227229

228230
6. 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>
229231
Some example commands you can try:
@@ -238,12 +240,12 @@ Take great care in downloading the one which suits your operating system (Linux,
238240

239241
* `exit` : Exits the app.
240242

241-
<div markdown="block" class="alert alert-success">
242-
243-
**:bulb: Tip:**<br>
244-
Refer to the [Features](#features) section below for details of each command.
245-
246-
</div>
243+
<div markdown="block" class="alert alert-success">
244+
245+
**:bulb: Tip:**<br>
246+
Refer to the [Features](#features) section below for details of each command.
247+
248+
</div>
247249

248250
--------------------------------------------------------------------------------------------------------------------
249251

@@ -275,7 +277,7 @@ Refer to the [Features](#features) section below for details of each command.
275277

276278
### Viewing help: `help`
277279

278-
Shows a message explaining how to access the help page.
280+
**Shows a message explaining how to access the help page.**
279281

280282
<img src="images/helpMessage.png" alt="help message" width="500"/>
281283

@@ -285,15 +287,21 @@ Format: `help`
285287

286288
### Listing all patients: `list`
287289

288-
Shows all patients in ImmuniMate.
290+
**Shows all patients in ImmuniMate.**
289291

290292
Format: `list`
291293

292294
<br>
293295

294296
### Creating a patient profile: `create`
295297

296-
Creates a patient profile in ImmuniMate. A patient profile refers to a record of a patient with a set of relevant information. For the complete field of information, refer to the [Field summary](#field-summary) at the end of this User Guide.
298+
**Creates a patient profile in ImmuniMate.**
299+
300+
<div markdown="block" class="alert alert-info">
301+
302+
**:information_source: Notes**<br>
303+
A patient profile refers to a record of a patient with a set of relevant information. For the complete field of information, refer to the [Field summary](#field-summary) at the end of this User Guide.
304+
</div>
297305

298306
Format: `create ic/<NRIC> n/<Patient_Name> hp/<Phone_Number> a/<Address> dob/<Date_of_birth> s/<Sex> st/<Status> [e/Email] [c/Country_of_Nationality] [doa/Date_of_Admission] [bt/Blood type] [al/Allergies] [con/Condition] [sym/Symptom] [d/diagnosis]`
299307

@@ -318,7 +326,7 @@ Examples:
318326

319327
### Read specific patients: `read`
320328

321-
Shows all profile details of patient with corresponding NRIC.
329+
**Shows all profile details of patient with corresponding NRIC.**
322330

323331
Format: `read <NRIC>`
324332
* The NRIC must follow the correct format specified in [Field Summary](#field-summary).
@@ -338,7 +346,7 @@ Examples:
338346

339347
### Updating a patient profile: `update`
340348

341-
Updates information of a patient with an existing profile in ImmuniMate.
349+
**Updates information of a patient with an existing profile in ImmuniMate.**
342350

343351
Format: `update <NRIC> <Field>/CONTENT`
344352

@@ -374,7 +382,7 @@ Examples:
374382

375383
### Finding patients by name: `find`
376384

377-
Finds patients whose names contain any of the given keywords.
385+
**Finds patients whose names contain any of the given keywords.**
378386

379387
Format: `find n/<NAME> [NAME] [NAME] ...`
380388

@@ -399,7 +407,7 @@ Examples:
399407

400408
### Finding patients by address: `find`
401409

402-
Finds patients whose addresses contain any of the given keywords.
410+
**Finds patients whose addresses contain any of the given keywords.**
403411

404412
Format: `find a/<LOCATION>, [LOCATION], [LOCATION], ...`
405413

@@ -426,7 +434,7 @@ Examples:
426434

427435
### Finding patients by condition: `find`
428436

429-
Finds patients whose conditions contain any of the given keywords.
437+
**Finds patients whose conditions contain any of the given keywords.**
430438

431439
Format: `find con/<CONDITION>, [CONDITION], [CONDITION], ...`
432440

@@ -460,7 +468,7 @@ If you would like to find a person with NRIC, use the `read` command instead.
460468

461469
### Deleting a patient: `delete`
462470

463-
Deletes the specified patient from ImmuniMate.
471+
**Deletes the specified patient from ImmuniMate.**
464472

465473
Format: `delete <NRIC>`
466474

@@ -482,7 +490,7 @@ Examples:
482490

483491
### Deleting information of a patient: `deleteinfo`
484492

485-
Deletes specified optional information from the specified person from ImmuniMate.
493+
**Deletes specified optional information from the specified person from ImmuniMate.**
486494

487495
Format: `deleteinfo <NRIC> <Field> [Field] [Field] ...`
488496

@@ -514,7 +522,7 @@ If you would like to change mandatory fields, you can use the `update` command i
514522

515523
### Add patient visit to history: `addvisit`
516524

517-
Adds visit to patient history.
525+
**Adds visit to patient history.**
518526

519527
Format: `addvisit ic/<NRIC> dov/<Date_of_Visit> sym/<Symptoms> d/<Diagnosis> st/<Status>`
520528

@@ -539,7 +547,7 @@ Examples:
539547

540548
### Check patient history: `check`
541549

542-
Checks all visits in patient history.
550+
**Checks all visits in patient history.**
543551

544552
Format: `check <NRIC>`
545553
* NRIC must be that of a patient already in ImmuniMate.
@@ -560,7 +568,7 @@ Example:
560568

561569
### Cluster finding: `cluster`
562570

563-
Shows whether or not the number of people **unwell** with the illness given (diagnosis in profile) in the location given is at least the integer given, and lists the people there with the illness.
571+
**Shows whether or not the number of people _unwell_ with the illness given (diagnosis in profile) in the location given is at least the integer given, and lists the people there with the illness.**
564572

565573
Format: `cluster <CLUSTER SIZE> a/<LOCATION> d/<DIAGNOSIS>`
566574

@@ -590,15 +598,15 @@ Example:
590598

591599
### Clearing all entries: `clear`
592600

593-
Clears all profiles from ImmuniMate.
601+
**Clears all profiles from ImmuniMate.**
594602

595603
Format: `clear`
596604

597605
<br>
598606

599607
### Exiting the program: `exit`
600608

601-
Exits the program.
609+
**Exits the program.**
602610

603611
Format: `exit`
604612

@@ -612,8 +620,8 @@ Arrow Key to view the next command. The Up and Down Arrow Keys can be found on t
612620
![Keyboard Arrow Keys](images/KeyboardArrowKeys.png)
613621

614622
**Notes:**
615-
1. The Command History only saves valid commands, it does not save commands that were unsuccessful.
616-
2. The Command History is temporary and will not be stored in between sessions. When you close an instance of ImmuniMate, your Command History is cleared.
623+
1. The Command History only saves **valid commands**, it does not save commands that were unsuccessful.
624+
2. The Command History is **temporary** and **will not be stored in between sessions**. When you close an instance of ImmuniMate, your Command History is cleared.
617625

618626
<br>
619627

0 commit comments

Comments
 (0)