From 086d51c6b67a594c9a57c5fd5dca89d329280dc2 Mon Sep 17 00:00:00 2001 From: SeaHogs <117960430+SeaHogs@users.noreply.github.com> Date: Sun, 24 Mar 2024 21:44:05 +0800 Subject: [PATCH 1/4] Update UserGuide.md -Update introduction and table of content. --- docs/UserGuide.md | 64 ++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 60 insertions(+), 4 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 2411a01883c..9077d881c17 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -3,10 +3,45 @@ layout: page title: User Guide --- -VitalConnect is a **desktop app for managing contacts, optimized for use via a Command Line Interface** (CLI) while still having the benefits of a Graphical User Interface (GUI). If you can type fast, AB3 can get your contact management tasks done faster than traditional GUI apps. +Welcome to **vitalConnect**, your all-in-one desktop application for efficient clinic management, optimized for both Command Line Interface (CLI) and Graphical User Interface (GUI). Designed to streamline your clinic management tasks, VitalConnect offers the speed of a CLI with the convenience of a GUI, allowing you to effortlessly organize your patient and appointments with just a few keystrokes. + +If you are relatively good at typing, having the benefit of CLI of reducing time of dragging your mouse around, vitalConnect empowers you to manage your appointments swiftly and effectively. With its intuitive interface and robust features, you can add, delete, and search for appointments, track medical information, as well as check patient contact for communication with ease. + +This user guide serves as your comprehensive manual for navigating **vitalConnect**'s features and functionalities. From quick-start instructions to detailed command summaries, you'll find everything you need to maximize your productivity and streamline your management workflow. + +So, whether you're a busy professional juggling multiple appointments, **vitalConnect** is here to simplify your life. Let's dive in and explore how **vitalConnect** can revolutionize the way you manage your appointment and patient. + +-------------------------------------------------------------------------------------------------------------------- + +## Table of Contents + +- [Quick start](#quick-start) +- [Features](#features) + - [Viewing help](#viewing-help--help) + - [Adding a patient](#adding-a-patient--add) + - [Listing all patients](#listing-all-patients--list) + - [Locating patients by name](#locating-patients-by-name--find) + - [Deleting a patient](#deleting-a-patient--delete) + - [Adding contact information](#adding-contact-information--addc) + - [Listing contact information](#listing-contact-information--listc) + - [Deleting contact information](#deleting-contact-information--deletec) + - [Adding medical information](#adding-medical-information--addm) + - [Listing medical information](#listing-medical-information--listm) + - [Deleting medical information](#deleting-medical-information--deletem) + - [Adding an appointment](#adding-an-appointment--adda) + - [Deleting an appointment](#deleting-an-appointment--deletea) + - [Listing appointments](#listing-appointments--lista) + - [Clearing all entries](#clearing-all-entries--clear) + - [Exiting the program](#exiting-the-program--exit) + - [Saving the data](#saving-the-data) + - [Editing the data file](#editing-the-data-file) + - [Archiving data files](#archiving-data-files-coming-in-v20) + - [Editing a patient](#editing-a-patient-coming-in-v13) +- [FAQ](#faq) +- [Known issues](#known-issues) +- [Command summary](#command-summary) + -* Table of Contents -{:toc} -------------------------------------------------------------------------------------------------------------------- @@ -18,7 +53,7 @@ VitalConnect is a **desktop app for managing contacts, optimized for use via a C 1. Copy the file to the folder you want to use as the _home folder_ for your vitalConnect. -1. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar vitalconnect.jar` command to run the application.
+1. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar vitalConnect.jar` command to run the application.
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.
![Ui](images/Ui.png) @@ -37,6 +72,8 @@ VitalConnect is a **desktop app for managing contacts, optimized for use via a C 1. Refer to the [Features](#features) below for details of each command. +[Back to Top](#top) + -------------------------------------------------------------------------------------------------------------------- ## Features @@ -71,6 +108,7 @@ Shows a message explaning how to access the help page. Format: `help` +[Back to Top](#top) ### Adding a patient: `add` Adds a patient to the clinic. @@ -80,12 +118,14 @@ Format: `add n/NAME ic/NRIC` Examples: * `add n/John Doe ic/S1234567D` +[Back to Top](#top) ### Listing all patients : `list` Shows a list of all patients in the clinic. Format: `list` +[Back to Top](#top) ### Locating patients by name: `find` Finds patients whose names contain any of the given keywords. @@ -103,6 +143,7 @@ Examples: * `find John` returns `John Doe` and `John Bard`
![result for 'find John'](images/findJohnResult.png) +[Back to Top](#top) ### Deleting a patient : `delete` Deletes the specified patient from the clinic. @@ -117,6 +158,7 @@ Examples: * `list` followed by `delete 2` deletes the 2nd patient in the clinic. * `find Betsy` followed by `delete 1` deletes the 1st patient in the results of the `find` command. +[Back to Top](#top) ### Adding contact information : `addc` Adds contact information to a patient in the clinic. @@ -138,10 +180,12 @@ Examples: * `addc ic/S1234567D e/test@email.com p/91234567` * `addc ic/S1234567D a/123, Clementi Rd, 1234665 e/test@email.com p/91234567` +[Back to Top](#top) ### Listing contact information : `listc` Lists all patients with contact information. +[Back to Top](#top) ### Deleting contact information : `deletec` Deletes contact information from a patient in the clinic. @@ -151,6 +195,7 @@ Format: `deletec ic/NRIC` Examples: * `deletec ic/S1234567D` will result in the contact information of the patient with NRIC `S1234567D` being deleted. +[Back to Top](#top) ### Adding medical information : `addm` Adds medical information to a patient in the clinic. @@ -161,10 +206,12 @@ Examples: * `addm ic/S1234567D h/163 w/50` * `addm ic/S1234567D h/163 w/50 t/insulin t/iodine` +[Back to Top](#top) ### Listing medical information : `listm` Lists all patients with medical information. +[Back to Top](#top) ### Deleting medical information : `deletem` Deletes medical information from a patient in the clinic. @@ -174,6 +221,7 @@ Format: `deletem ic/NRIC` Examples: * `deletem ic/S1234567D` will result in the medical information of the patient with NRIC `S1234567D` being deleted. +[Back to Top](#top) ### Adding an appointment: `adda` Adds an appointment for a patient to the appointment list. @@ -183,6 +231,7 @@ Format: `adda NRIC /time DD/MM/YYYY HHMM` Examples: * `adda S1234567D /time 02/02/2024 1300` will add an appointment for the patient with NRIC `S1234567D` on 2nd February 2024 at 1:00 PM. +[Back to Top](#top) ### Adding an appointment: `deletea` Delete an exist appointment from the appointment list by providing the index of the appointment @@ -193,12 +242,14 @@ Format: `deletea INDEX /name NAME` Examples: * `deletea 1 /name Amy` +[Back to Top](#top) ### List out appointments: `lista` List out all the appointments in the appointment list. Format: `lista` +[Back to Top](#top) ### Clearing all entries : `clear` Clears all entries from the clinic. @@ -208,16 +259,19 @@ Format: `clear` > [!CAUTION] > This command will delete all the patients from the clinic. Please use with cautious. +[Back to Top](#top) ### Exiting the program : `exit` Exits the program. Format: `exit` +[Back to Top](#top) ### Saving the data Clinic data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually. +[Back to Top](#top) ### Editing the data file Clinic data are saved automatically as a JSON file `[JAR file location]/data/clinic.json`. Advanced users are welcome to update data directly by editing that data file. @@ -267,3 +321,5 @@ _Details coming soon ..._ | **Lista** | `lista` | | **Deletea** | `deletea INDEX /name NAME` e.g., `deletea 1 /name Amy` | | **Help** | `help` | + +[Back to Top](#top) \ No newline at end of file From 5ee0191c18d65f11ee39e376b8ce4a81e14991a5 Mon Sep 17 00:00:00 2001 From: SeaHogs <117960430+SeaHogs@users.noreply.github.com> Date: Sun, 24 Mar 2024 21:51:56 +0800 Subject: [PATCH 2/4] Update Github account --- docs/AboutUs.md | 2 +- docs/UserGuide.md | 1 - 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/AboutUs.md b/docs/AboutUs.md index 08f60a097a1..d61902c06b7 100644 --- a/docs/AboutUs.md +++ b/docs/AboutUs.md @@ -43,7 +43,7 @@ You can reach us at the email `seer[at]comp.nus.edu.sg` -[[github](http://github.com/johndoe)] +[[github](https://github.com/SeaHogs)] [[portfolio](team/seahogs.md)] * Role: Developer diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 9077d881c17..a81fef35a81 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -42,7 +42,6 @@ So, whether you're a busy professional juggling multiple appointments, **vitalCo - [Command summary](#command-summary) - -------------------------------------------------------------------------------------------------------------------- ## Quick start From 5653c59666d6b7afa00b44308659ec5fe47ef60f Mon Sep 17 00:00:00 2001 From: SeaHogs <117960430+SeaHogs@users.noreply.github.com> Date: Sun, 24 Mar 2024 22:01:44 +0800 Subject: [PATCH 3/4] Fix UserGuide.md --- docs/UserGuide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index a81fef35a81..97a5f870aa7 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -321,4 +321,4 @@ _Details coming soon ..._ | **Deletea** | `deletea INDEX /name NAME` e.g., `deletea 1 /name Amy` | | **Help** | `help` | -[Back to Top](#top) \ No newline at end of file +[Back to Top](#top) From 7178a92c0a60171d2847a93fe1c6e676b76f97a0 Mon Sep 17 00:00:00 2001 From: SeaHogs <117960430+SeaHogs@users.noreply.github.com> Date: Sun, 24 Mar 2024 22:21:35 +0800 Subject: [PATCH 4/4] Fix UserGuide.md --- docs/UserGuide.md | 37 ++++++++++++++++++++++++++++--------- 1 file changed, 28 insertions(+), 9 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 97a5f870aa7..2808603e7b1 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -2,19 +2,22 @@ layout: page title: User Guide --- +## Introduction Welcome to **vitalConnect**, your all-in-one desktop application for efficient clinic management, optimized for both Command Line Interface (CLI) and Graphical User Interface (GUI). Designed to streamline your clinic management tasks, VitalConnect offers the speed of a CLI with the convenience of a GUI, allowing you to effortlessly organize your patient and appointments with just a few keystrokes. If you are relatively good at typing, having the benefit of CLI of reducing time of dragging your mouse around, vitalConnect empowers you to manage your appointments swiftly and effectively. With its intuitive interface and robust features, you can add, delete, and search for appointments, track medical information, as well as check patient contact for communication with ease. -This user guide serves as your comprehensive manual for navigating **vitalConnect**'s features and functionalities. From quick-start instructions to detailed command summaries, you'll find everything you need to maximize your productivity and streamline your management workflow. +This user guide serves as your comprehensive manual for navigating vitalConnect's features and functionalities. From quick-start instructions to detailed command summaries, you'll find everything you need to maximize your productivity and streamline your management workflow. -So, whether you're a busy professional juggling multiple appointments, **vitalConnect** is here to simplify your life. Let's dive in and explore how **vitalConnect** can revolutionize the way you manage your appointment and patient. +So, whether you're a busy professional juggling multiple appointments, vitalConnect is here to simplify your life. Let's dive in and explore how vitalConnect can revolutionize the way you manage your appointment and patient. -------------------------------------------------------------------------------------------------------------------- ## Table of Contents + + - [Quick start](#quick-start) - [Features](#features) - [Viewing help](#viewing-help--help) @@ -30,13 +33,12 @@ So, whether you're a busy professional juggling multiple appointments, **vitalCo - [Deleting medical information](#deleting-medical-information--deletem) - [Adding an appointment](#adding-an-appointment--adda) - [Deleting an appointment](#deleting-an-appointment--deletea) - - [Listing appointments](#listing-appointments--lista) + - [Listing appointments](#list-out-appointment--lista) - [Clearing all entries](#clearing-all-entries--clear) - [Exiting the program](#exiting-the-program--exit) - [Saving the data](#saving-the-data) - [Editing the data file](#editing-the-data-file) - [Archiving data files](#archiving-data-files-coming-in-v20) - - [Editing a patient](#editing-a-patient-coming-in-v13) - [FAQ](#faq) - [Known issues](#known-issues) - [Command summary](#command-summary) @@ -108,7 +110,8 @@ Shows a message explaning how to access the help page. Format: `help` [Back to Top](#top) -### Adding a patient: `add` + +### Adding a patient : `add` Adds a patient to the clinic. @@ -118,6 +121,7 @@ Examples: * `add n/John Doe ic/S1234567D` [Back to Top](#top) + ### Listing all patients : `list` Shows a list of all patients in the clinic. @@ -125,7 +129,8 @@ Shows a list of all patients in the clinic. Format: `list` [Back to Top](#top) -### Locating patients by name: `find` + +### Locating patients by name : `find` Finds patients whose names contain any of the given keywords. @@ -143,6 +148,7 @@ Examples: ![result for 'find John'](images/findJohnResult.png) [Back to Top](#top) + ### Deleting a patient : `delete` Deletes the specified patient from the clinic. @@ -158,6 +164,7 @@ Examples: * `find Betsy` followed by `delete 1` deletes the 1st patient in the results of the `find` command. [Back to Top](#top) + ### Adding contact information : `addc` Adds contact information to a patient in the clinic. @@ -180,11 +187,13 @@ Examples: * `addc ic/S1234567D a/123, Clementi Rd, 1234665 e/test@email.com p/91234567` [Back to Top](#top) + ### Listing contact information : `listc` Lists all patients with contact information. [Back to Top](#top) + ### Deleting contact information : `deletec` Deletes contact information from a patient in the clinic. @@ -195,6 +204,7 @@ Examples: * `deletec ic/S1234567D` will result in the contact information of the patient with NRIC `S1234567D` being deleted. [Back to Top](#top) + ### Adding medical information : `addm` Adds medical information to a patient in the clinic. @@ -206,11 +216,13 @@ Examples: * `addm ic/S1234567D h/163 w/50 t/insulin t/iodine` [Back to Top](#top) + ### Listing medical information : `listm` Lists all patients with medical information. [Back to Top](#top) + ### Deleting medical information : `deletem` Deletes medical information from a patient in the clinic. @@ -221,7 +233,8 @@ Examples: * `deletem ic/S1234567D` will result in the medical information of the patient with NRIC `S1234567D` being deleted. [Back to Top](#top) -### Adding an appointment: `adda` + +### Adding an appointment : `adda` Adds an appointment for a patient to the appointment list. @@ -231,7 +244,8 @@ Examples: * `adda S1234567D /time 02/02/2024 1300` will add an appointment for the patient with NRIC `S1234567D` on 2nd February 2024 at 1:00 PM. [Back to Top](#top) -### Adding an appointment: `deletea` + +### Deleting an appointment : `deletea` Delete an exist appointment from the appointment list by providing the index of the appointment in the list and the name of the patient. @@ -242,13 +256,15 @@ Examples: * `deletea 1 /name Amy` [Back to Top](#top) -### List out appointments: `lista` + +### List out appointments : `lista` List out all the appointments in the appointment list. Format: `lista` [Back to Top](#top) + ### Clearing all entries : `clear` Clears all entries from the clinic. @@ -259,6 +275,7 @@ Format: `clear` > This command will delete all the patients from the clinic. Please use with cautious. [Back to Top](#top) + ### Exiting the program : `exit` Exits the program. @@ -266,11 +283,13 @@ Exits the program. Format: `exit` [Back to Top](#top) + ### Saving the data Clinic data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually. [Back to Top](#top) + ### Editing the data file Clinic data are saved automatically as a JSON file `[JAR file location]/data/clinic.json`. Advanced users are welcome to update data directly by editing that data file.