Merge branch 'master' into branch-UG-Gabriel

docs/AboutUs.md

@@ -47,12 +47,12 @@ You can reach us at the email `seer[at]comp.nus.edu.sg`
 
 * Role: Developer
 
-### James Doe
+### Gabriel Seethor Jun Hao
 
-<img src="images/johndoe.png" width="200px">
+<img src="images/gabriel4357.png" width="200px">
 
-[[github](http://github.com/johndoe)]
-[[portfolio](team/johndoe.md)]
+[[github](http://github.com/gabriel4357)]
+[[portfolio](team/gabriel4357.md)]
 
-* Role: Developer
-* Responsibilities: UI
+* Role: Scheduling and Tracking 
+* Responsibilities:  In charge of defining, assigning, and tracking project tasks.

docs/DeveloperGuide.md

@@ -4,7 +4,7 @@ title: "Developer Guide"
 pageNav: 3
 ---
 
-# AB-3 Developer Guide
+# HomeBoss Developer Guide
 
 <!-- * Table of Contents -->
 <page-nav-print />
@@ -330,13 +330,18 @@ _{Explain here how the data archiving feature will be implemented}_
 
 **Target user profile**:
 
-* has a need to manage a significant number of contacts
+* has a home business
+* want to oversee customers in an organised manner
+* want to manage deliveries efficiently and effectively
 * prefer desktop apps over other types
 * can type fast
 * prefers typing to mouse interactions
 * is reasonably comfortable using CLI apps
 
-**Value proposition**: manage contacts faster than a typical mouse/GUI driven app
+**Value proposition**: 
+Home-based business owners can have a huge base of customers. 
+HomeBoss streamlines and simplifies the management of customer contacts and deliveries,
+thereby improving efficiency for business owners.
 
 ### User stories
 
@@ -427,9 +432,17 @@ otherwise)
 ### Non-Functional Requirements
 
 1. Should work on any _mainstream OS_ as long as it has Java `11` or above installed.
-2. Should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage.
-3. A user with above average typing speed for regular English text (i.e. not code, not system admin commands) should be
+2. Should be able to hold up to 
+   1. 1000 customers without a noticeable sluggishness in performance for typical usage.
+   2. 1000 deliveries without a noticeable sluggishness in performance for typical usage.
+3. The system should be easily picked up by a novice with no experience with contact management software.
+4. A user with above average typing speed for regular English text (i.e. not code, not system admin commands) should be
    able to accomplish most of the tasks faster using commands than using the mouse.
+5. Data stored should be persistent until removal by user, and Private Contact Details should be secure.
+6. The project is expected to adhere to a schedule which delivers a feature set every milestone up to _V1.3_
+7. The application is not expected to 
+   1. Perform Inventory Management
+   2. Perform Route Planning
 
 *{More to be added}*
 

docs/UserGuide.md

@@ -182,7 +182,7 @@ _ADDRESS_: String
 
 _CUSTOMER_ID_: Integer
 
-\*At least one of the optional fields must be provided.
+*At least one of the optional fields must be provided.
 
 **Command succeeds:** _Customer 1, Gabriel has been updated!_
 
@@ -248,21 +248,17 @@ Shows a list of all deliveries.
 
 **Accepted Values:**
 
-_ STATUS_: all or pending or complete
+_STATUS_: String of either `all` or `pending` or `complete`
 
-    _SORT: _asc for ascending or desc for descending. If unspecified, default to sort by delivery date.
+_SORT_: String of either `asc` for ascending or `desc` for descending or empty string for sorting by delivery date
 
-**Command succeeds (>0 deliveries):**
+**Command succeeds (>0 deliveries):** _Here are all the deliveries:_
 
-_Here are all the deliveries:_
+1. _[1001] Gabriel’s Milk - Completed - Ordered 20th Sept 2023 : Delivered on 30th Sept 2023_
+2. _[1002] Gambe’s Meat - Completed - Ordered 22th Sept 2023 : Delivered on 29th Sept 2023_
+3. _[1003] Ben’s Coffee - Pending - Ordered 25th Sept 2023 : Delivery on 1st October 2023_
 
-1. [1001] Gabriel’s Milk - Completed - Ordered 20th Sept 2023 : Delivered on 30th Sept 2023
-2. [1002] Gambe’s Meat - Completed - Ordered 22th Sept 2023 : Delivered on 29th Sept 2023
-3. [1003] Ben’s Coffee - Pending - Ordered 25th Sept 2023 : Delivery on 1st October 2023
-
-**Command failed (0 deliveries): **
-
-_There are currently no deliveries!_
+**Command failed (0 deliveries):** _There are currently no deliveries!_
 
 ### View details of deliveries
 
@@ -278,24 +274,14 @@ _DELIVERY_ID_: Integer
 
 **Command succeeds:**
 
-    _[1001] Gabriel’s Milk_
-
-
-    _Customer ID: 1_
-
-
-    _Customer: Gabriel_
-
-
-    _Ordered on : 23rd September 2023_
-
+_[1001] Gabriel’s Milk_<br />
+_Customer ID: 1_<br />
+_Customer: Gabriel_<br />
+_Ordered on : 23rd September 2023_<br />
+_Delivery Status: Pending_<br />
+_Delivery on : 1st October 2023_
 
-    _Delivery Status: Pending_
-
-
-    _Delivery on : 1st October 2023_
-
-**Command failed (0 deliveries): _There are currently no deliveries. _**
+**Command failed (0 deliveries):** _There are currently no deliveries._
 
 ### Update delivery status and date
 
@@ -305,78 +291,77 @@ _DELIVERY_ID_: Integer
 
 #### Mark delivery as complete
 
-#### **Format**: `delivery complete DELIVERY_ID`
+**Format**: `delivery complete DELIVERY_ID`
 
 **Example**: `delivery complete 1001`
 
 **Accepted Values:**
 
-    _DELIVERY_ID_: Integer
+_DELIVERY_ID:_ Integer
 
-**Command succeeds:** _Delivery [1001] Gabriel’s Milk marked as pending! _
+**Command succeeds:** _Delivery [1001] Gabriel’s Milk marked as complete!_
 
-**Command failed (delivery*name missing): \_Please specify a delivery name to delete!***
+**Command failed (delivery_name missing):** _Please specify a delivery name!_
 
 **Command failed (delivery_name not in database):** _This delivery does not seem to exist!_
 
-**Command failed (delivery already complete): _This delivery is already marked as complete._**
+**Command failed (delivery already complete):** _This delivery is already marked as complete._
 
 #### Mark delivery as pending
 
 **Format:** `delivery pending DELIVERY_ID`
 
-**Example: `delivery pending 1001`**
+**Example:** `delivery pending 1001`
 
 **Accepted Values:**
 
 _DELIVERY_ID_: Integer
 
-**Command succeeds:** _Delivery [1001] Gabriel’s Milk marked as pending! _
+**Command succeeds:** _Delivery [1001] Gabriel’s Milk marked as pending!_
 
-**Command failed (delivery_name missing):** _Please specify a delivery name to delete!_
+**Command failed (delivery_name missing):** _Please specify a delivery name!_
 
-**Command failed (delivery_name not in database):** _This delivery does not seem to exist! _
+**Command failed (delivery_name not in database):** _This delivery does not seem to exist!_
 
-**Command failed (delivery already pending): _This delivery is already marked as pending._**
+**Command failed (delivery already pending):** _This delivery is already marked as pending._
 
 #### Change date of delivery
 
-**Format**: `delivery edit date DELIVERY_ID --date DATE`
+**Format:** `delivery edit date DELIVERY_ID --date DATE`
 
-**Example**: `delivery edit date 1001 --date 2023-12-12`
+**Example:** `delivery edit date 1001 --date 2023-12-12`
 
 **Accepted Values:**
 
-    _DELIVERY_ID_: Integer
-
+_DELIVERY_ID:_ Integer
 
-    _DATE: _YYYY-MM-DD
+_DATE:_ String of format YYYY-MM-DD
 
-**Command succeeds:** _Delivery [1001] Gabriel’s Milk changed delivery date to 1st Oct 2023! _
+**Command succeeds:** _Delivery [1001] Gabriel’s Milk changed delivery date to 1st Oct 2023!_
 
-**Command failed (one field missing): _Please specify a delivery name and date!_**
+**Command failed (one field missing):** _Please specify a delivery name and date!_
 
-**Command failed (invalid date format): _Please format date as YYYY-MM-DD. _**
+**Command failed (invalid date format):** _Please format date as YYYY-MM-DD._
 
-**Command failed (delivery*name not in database): \_This delivery does not seem to exist! ***
+**Command failed (delivery_name not in database):** _This delivery does not seem to exist!_
 
 ### Delete delivery
 
 Deletes the specified delivery.
 
-**Format**: `delivery delete DELIVERY_ID`
+**Format:** `delivery delete DELIVERY_ID`
 
-**Example**: `delivery delete 1001`
+**Example:** `delivery delete 1001`
 
 **Accepted Values:**
 
 _DELIVERY_ID_: Integer
 
-**Command succeeds:** _Delivery [1001] Gabriel’s Milk deleted! _
+**Command succeeds:** _Delivery [1001] Gabriel’s Milk deleted!_
 
 **Command failed (delivery_name missing):** _Please specify a delivery name to delete!_
 
-**Command failed (delivery*name not in database): \_This delivery does not seem to exist***
+**Command failed (delivery_name not in database):** _This delivery does not seem to exist!_
 
 ### Create a note for a delivery `[Coming Soon in v1.3]`
 

docs/team/zhonghan721.md

@@ -5,8 +5,8 @@
 
 ### Project: HomeBoss
 
-HomeBoss is a desktop application used for managing deliveries for home business owners. 
-The user interacts with it using a CLI, and it has a GUI created with JavaFX. 
+HomeBoss is a desktop application used for managing deliveries for home business owners.
+The user interacts with it using a CLI, and it has a GUI created with JavaFX.
 It is written in Java, and has about 10 kLoC.
 
 Given below are my contributions to the project.