From e4c0a0f3503252c7998b803a61340eec385d0e61 Mon Sep 17 00:00:00 2001 From: Gabriel4357 Date: Tue, 3 Oct 2023 21:16:33 +0800 Subject: [PATCH 1/3] Standardise my portion of UG with rest of the team --- docs/UserGuide.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 92305f24b36..fb4f83b899b 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -116,10 +116,9 @@ _Details coming soon..._ Adds a customer to the address book. -**Format: `customer add --name NAME --phone PHONE_NUMBER --email EMAIL --address ADDRESS`** +**Format:** `customer add --name NAME --phone PHONE_NUMBER --email EMAIL --address ADDRESS` -**Example: customer add --name Gabriel --phone 8765 4321** ---email [gabrielrocks@gmail.com](mailto:gabrielrocks@gmail.com) --address RVRC Block B +**Example:** `customer add --name Gabriel --phone 8765 4321 --email gabrielrocks@gmail.com --address RVRC Block B` **Accepted Values:** @@ -131,10 +130,10 @@ _EMAIL_: String with @ and . in valid email format _ADDRESS_: String -**Command succeeds: _Customer 1, Gabriel added._** +**Command succeeds:** _Customer 1, Gabriel added._ -**Command fails (missing field): _Please fill up all the required fields (--name NAME --phone PHONE_NUMBER --email -EMAIL --address ADDRESS)._** +**Command fails (missing field):** _Please fill up all the required fields (--name NAME --phone PHONE_NUMBER --email +EMAIL --address ADDRESS)._ ### Search for a customer `[Coming Soon in v1.3]` _Details coming soon..._ From 34e0cc6b4d88a01bf7f65f1bf4a50595f61e98e0 Mon Sep 17 00:00:00 2001 From: B-enguin Date: Tue, 3 Oct 2023 21:26:06 +0800 Subject: [PATCH 2/3] Close #77 Standardise UG for Customer and Delivery Sections. --- docs/UserGuide.md | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 92305f24b36..aacf5d6eb85 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -143,16 +143,17 @@ _Details coming soon..._ Lists all the customers added in the address book. -**Format**: `customer list` +**Format:** `customer list` -**Example**: `customer list` +**Example:** `customer list` **Accepted Values:** _NIL_ -**Command succeeds (>0 customers):** _Here is the list of customers:_ +**Command succeeds (>0 customers):** +_Here is the list of customers:_ 1. _Benjamin, Phone: 9898 2323, Email: benjaminCSGod@gmail.com, Address: Carnegie Mellon University, South Block._ 2. _Gambe, Phone: 9797 1313, Email: gambeRizzLord@gmail.com, Address: Kent Ridge Hall_ 3. _Gabriel, Phone: 9090 9241, Email: gabrielSoCool@gmail.com, Address: RVRC Tower Block_ @@ -166,9 +167,9 @@ _Details coming soon..._ Updates the personal details of an existing customer in the address book. -**Format**: `customer edit CUSTOMER_ID [--name NAME] [--phone PHONE_NUMBER] [--email EMAIL] [--address ADDRESS]` +**Format:** `customer edit CUSTOMER_ID [--name NAME] [--phone PHONE_NUMBER] [--email EMAIL] [--address ADDRESS]` -**Example**: `customer edit 1001 --name Gabriel -–phone 1234 5678 --email gabrielSoCool@gmail.com --address RVRC Block B Ben's Room` +**Example:** `customer edit 1001 --name Gabriel -–phone 1234 5678 --email gabrielSoCool@gmail.com --address RVRC Block B Ben's Room` **Accepted Values:** @@ -228,16 +229,20 @@ _DELIVERY_NAME:_ String of 50 characters _CUSTOMER_ID:_ Integer -_DATE:_ YYYY-MM-DD format +_DATE:_ String in YYYY-MM-DD format **Command succeeds:** _Delivery [1001] furniture created successfully for Customer 1, Gabriel!_ -**Command fails (missing_fields):** _Please fill up all the required fields (--name NAME --id CUSTOMER_ID --date DATE)!_ +**Command fails (missing_fields):** _Please fill up all the required fields (DELIVERY_NAME --customer CUSTOMER_ID --date DATE)!_ **Command fails (invalid_date):** _Invalid date provided!_ **Command fails (invalid_date_format):** _Please provide the date in the format: YYYY-MM-DD._ +### Create a note for a delivery `[Coming Soon in v1.3]` + +_Details coming soon..._ + ### View all deliveries Shows a list of all deliveries. @@ -363,10 +368,6 @@ _DELIVERY_ID_: Integer **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]` - -_Details coming soon..._ - ### View deliveries for the day `[Coming Soon in v1.3]` _Details coming soon..._ From 45b05dca5f72e2c71a1b8692c9af42a391e858ce Mon Sep 17 00:00:00 2001 From: Julius Bryan <67666355+juliusgambe@users.noreply.github.com> Date: Tue, 3 Oct 2023 21:26:12 +0800 Subject: [PATCH 3/3] Fix user section --- docs/UserGuide.md | 50 +++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 92305f24b36..56ccca63a9c 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -8,14 +8,12 @@ your operations. Within these pages, you'll find detailed coverage of the follow - Features - User - Register - - Secure account with a password (?) - Login - Forget password [Coming Soon] - Logout - Change password [Coming Soon] - - Update details [Coming Soon] + - Update user details [Coming Soon] - Delete account [Coming Soon] - - Recover password (?) - Customer - Add customer - Search for a customer [Coming Soon] @@ -27,7 +25,7 @@ your operations. Within these pages, you'll find detailed coverage of the follow - Create delivery - View all deliveries - View details of deliveries - - Update delivery status and date + - Update delivery status and date - Delete delivery - Create a note for a delivery [Coming Soon] - View deliveries for the day [Coming Soon] @@ -36,15 +34,11 @@ your operations. Within these pages, you'll find detailed coverage of the follow - Look up delivery details [Coming Soon] - Troubleshooting / FAQ -# - # Getting Started To get started, you will need to create an account and download the software. Once you have done that, you can follow the instructions in the Getting Started Guide to start using the software. -# - # Features \*[ ] specifies optional fields @@ -53,9 +47,9 @@ the instructions in the Getting Started Guide to start using the software. ### Register -**Format: `register --user USERNAME --password PASSWORD --confirmPass CONFIRM_PASSWORD`** +**Format:** `register --user USERNAME --password PASSWORD --confirmPass CONFIRM_PASSWORD` -**Example: `register --user gabriel --password gabrielIsGreat --confirmPass gabrielIsGreat`** +**Example:** `register --user gabriel --password gabrielIsGreat --confirmPass gabrielIsGreat` **Accepted Values:** @@ -63,19 +57,19 @@ _USERNAME:_ String _PASSWORD:_ String -_CONFIRM PASSWORD:_ String that is the same as PASSWORD. +_CONFIRM PASSWORD:_ String that is the same as _PASSWORD_. -**Command succeeds: _Register successful._** +**Command succeeds:** _Register successful._ -**Command fails (missing fields): _Please fill up all the required fields._** +**Command fails (missing fields):** _Please fill up all the required fields._ -**Command fails (password does not match): _Passwords do not match. Try again._** +**Command fails (password does not match):** _Passwords do not match. Try again._ ### Login -**Format: `login --user USERNAME --password PASSWORD`** +**Format:** `login --user USERNAME --password PASSWORD` -**Example: `login --user gabriel --password gabrielIsGreat`** +**Example:** `login --user gabriel --password gabrielIsGreat` **Accepted Values:** @@ -83,32 +77,35 @@ _USERNAME:_ String _PASSWORD:_ String -**Command succeeds: _Log in successful._** +**Command succeeds:** _Log in successful._ -**Command fails (missing fields): _Please fill up all the required fields._** +**Command fails (missing fields):** _Please fill up all the required fields._ -**Command fails (wrong login credentials): _Wrong username and/or password. Try again._** +**Command fails (wrong login credentials):** _Wrong username and/or password. Try again._ ### Forget Password `[Coming Soon in v1.3]` + _Details coming soon..._ ### Logout -**Format: `logout`** +**Format:** `logout` -**Example: `logout`** +**Example:** `logout` -**Command succeeds: _Logout successful._** +**Command succeeds:** _Logout successful._ ### Change Password `[Coming Soon in v1.3]` + _Details coming soon..._ ### Update details `[Coming Soon in v1.3]` + _Details coming soon..._ ### Delete Account `[Coming Soon in v1.3]` -_Details coming soon..._ +_Details coming soon..._ ## Customer @@ -133,10 +130,11 @@ _ADDRESS_: String **Command succeeds: _Customer 1, Gabriel added._** -**Command fails (missing field): _Please fill up all the required fields (--name NAME --phone PHONE_NUMBER --email +**Command fails (missing field): _Please fill up all the required fields (--name NAME --phone PHONE_NUMBER --email EMAIL --address ADDRESS)._** ### Search for a customer `[Coming Soon in v1.3]` + _Details coming soon..._ ### List customers @@ -160,6 +158,7 @@ _NIL_ **Command succeeds (0 customer):** _There are no customers added yet!_ ### Sort the list of customers `[Coming Soon in v1.3]` + _Details coming soon..._ ### Update customer details @@ -168,7 +167,8 @@ Updates the personal details of an existing customer in the address book. **Format**: `customer edit CUSTOMER_ID [--name NAME] [--phone PHONE_NUMBER] [--email EMAIL] [--address ADDRESS]` -**Example**: `customer edit 1001 --name Gabriel -–phone 1234 5678 --email gabrielSoCool@gmail.com --address RVRC Block B Ben's Room` +** +Example**: `customer edit 1001 --name Gabriel -–phone 1234 5678 --email gabrielSoCool@gmail.com --address RVRC Block B Ben's Room` **Accepted Values:**