diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 26bde953184..dac7a4da58c 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -4,18 +4,34 @@ title: MediCLI User Guide --- ## Welcome to MediCLI! -[Welcome note] -MediCLI is a **desktop app for managing persons involved in a hospital, optimised for use via a Command Line Interface** (CLI) while still having the benefits of a Graphical User Interface (GUI). Targeted at fast typing hospital clerks, MediCLI allows them to manage doctors, patients and appointments faster than traditional GUI apps. +Welcome to MediCLI - the solution to all your hospital management needs! + +MediCLI is a desktop-based application that streamlines the management of patients, doctors, and appointments within a hospital. By combining the efficiency of a Command Line Interface (CLI) with an intuitive and comprehensive visual display, MediCLI presents itself as a robust solution for hospital clerks and administrators such as yourself. This guide will equip you with all the knowledge to become a MediCLI power-user and truly transform your hospital management experience. + ## Who can benefit from MediCLI? -[Target audience] +MediCLI is tailored built for hospital clerks/administrators or anyone who manages the relevant stakeholders in a hospital setting and seeks to optimize their workflow. + +### Prior knowledge: +MediCLI will be particularly beneficial for you are either (or both of): +- a fast-typer or, +- and familar with a CLI, +enabling you to get up to speed and perform tasks swiftly and efficiently. +That being said, even if you do not meet the above criteria, do not fret! Follow this guide, practice a little, and in only a couple of days you too can take full advantage of MediCLI's features to manage doctors, patients, and appointments seamlessly. * Table of Contents {:toc} --------------------------------------------------------- ## Purpose of UG +This User Guide (UG) guide provides step-by-step instructions, explanations, and tips to help users to make the most out of MediCLI regardless of experience. + +#### For new users +This UG offers a comprehensive overview of the features on offer, and provide you with a step-by-step guide on how to get started. + +#### For experienced MediCLI users: +You may skip to the features section which elaborates on the individual commands that you can run to get the most out of the system. ## How to use this UG As you read through this MediCLI User Guide, you will come across a variety of different types of text formats. The table below will explain to you what they mean. @@ -34,10 +50,31 @@ Take note of these text-boxes, as they give you important information for using -------------------------------------------------------------------------------------------------------------------- ## Key Product Information -[provides a user-centric statement detailing -product information, including product -description and an overview of main -features.] + +### Product Description +MediCLI is a Java-based desktop-application that allows you to manage your hospital with ease. Let's now explore the product in more detail. + +### Overview of main features + +#### Entities that you can manage with MediCLI +MediCLI allows you to manage three types of entities that are common in a hospital setting: +- **Doctors**: The doctors employed by your hospital +- **Patients**: The patients that are treated at your hospital +- **Appointments**: A medical appointment between a doctor and a patient that takes place at a specified time + +#### Operations that you can perform with MediCLI +MediCLI allows you to perform the following operations of each of the entities above: +- Add: Add entities to the application +- Delete: Delete entities from the application +- Query: Lookup an entity in the application based on some criteria +- Edit: Edit the attributes of entities + +#### Other notable features +On top of the primary entities and operations highlighted above, MediCLI also provides the following capabilities: +- Persistent storage of information across restarts of the application +- A clean and minimalist display to view relevant information on entities +- Thorough error messages and in-app prompts guiding you on how to overcome any issues you may run into. + ## Quick start Guide @@ -344,7 +381,7 @@ Command Constraints: * The order of the keywords does not matter. e.g. `Hans Bo` will match `Bo Hans` * All person fields are searched and matched (Name, NRIC, Phone Number, DoB). * Both full words and substrings will be matched e.g. `Han` will match `Hans` -* Doctors matching at least one keyword will be returned (i.e. logical 'or' search). +* Doctors matching at least one keyword will be returned (i.e. `OR` search). e.g. `Hans Bo` will return `Hans Gruber`, `Bo Yang` Examples: