From e79ea7447b7f74902a33ea967651a300b898204d Mon Sep 17 00:00:00 2001 From: tiif Date: Wed, 8 Nov 2023 17:09:19 +0800 Subject: [PATCH 1/3] Update faq and command summary in UG --- docs/UserGuide.md | 50 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index 983f84f2ff6..b867973d01e 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -17,6 +17,8 @@ Here’s a quick overview of D.A.V.E.’s features - [Glossary](#Glossary) - [Tutorial for new users](#D.A.V.E.-Tutorial-for-new-users) - [Features](#Features) +- [FAQ](#faq) +- [Known issues](#known-issues) # Glossary @@ -380,3 +382,51 @@ from current date to ensure a follow-up by the user. - Precise expected outputs when the command fails: `The person index provided is invalid` + +--------------------------------------------------------------------------- +## FAQ + +**Q**: How do I transfer my data to another computer?
+**A**: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous JobFestGo home folder. + +**Q**: What do I do if the clicking of the Dave JAR file does not work?
+**A**: Given below are the steps to launch Dave using CLI: + +1. Open the command prompt +1. Navigate to the directory where the JAR file is located using cd [JAR file location] +//fix this +1. Type `java -jar dave.jar` and press enter +1. Dave should launch + +**Q**: How can I check my Java version? +**A**: Open a command prompt and type `java -version` . If you do not have Java installed, you +can download it [here](https://www.oracle.com/java/technologies/downloads/#java11). + +--------------------------------------------------------------------------------- + +## Known issues + +1. **When using multiple screens**, if you move the application to a secondary screen, and later switch to using only the primary screen, the GUI will open off-screen. The remedy is to delete the `preferences.json` file created by the application before running the application again. + +---------------------------------------------------------------------------------- +## Command summary + + +Action | Format, Examples +-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------- +**Add lead** | `addlead n/NAME p/PHONE e/EMAIL a/ADDRESS k/KEY_MILESTONE [m/MEETING_TIME] [t/TAG]...​`
e.g. `addlead n/John Doe p/98765432 e/johnd@example.com a/311, Clementi Ave 2, #02-25 k/01/12/2023 m/10/10/2023 14:30 t/classmate` +**Add client** | `addclient n/NAME p/PHONE e/EMAIL a/ADDRESS [m/MEETING_TIME] [t/TAG]...​`
e.g. `addclient n/John Doe p/98765432 e/johnd@example.com a/311, Clementi Ave 2, #02-25 m/10/10/2023 14:30 t/classmate` +**View all leads and clients** | `list` +**View all clients** | `listclient` +**View all leads** | `listlead` +**View a specific person** | `view INDEX`
e.g. `view 1` +**Delete** | `delete INDEX`
e.g. `delete 1` +**Add meeting time** | `addmeeting INDEX m/MEETING_TIME`
e.g. `addmeeting 1 m/12/10/2023 16:00` +**Delete meeting time** | `deletemeeting INDEX`
e.g. `deletemeeting 1` +**Edit** | `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [k/KEY_MILESTONE] [t/TAG]...​`
e.g. `edit 1 n/John Doe p/98765432` +**Sort meeting time** | `sortmeeting` +**Convert lead to client** | `convertoclient INDEX`
e.g. `converttoclient 1` +**Convert client to lead** | `convertolead INDEX`
e.g. `converttolead 1` +**Clear** | `clear` +**Help** | `help` +**Exit** | `exit` From b41ca93209628d5ba1e2b019e6768af1be0e931c Mon Sep 17 00:00:00 2001 From: tiif Date: Wed, 8 Nov 2023 18:20:56 +0800 Subject: [PATCH 2/3] Update UG --- docs/UserGuide.md | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/UserGuide.md b/docs/UserGuide.md index b867973d01e..591efbe6275 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -19,6 +19,7 @@ Here’s a quick overview of D.A.V.E.’s features - [Features](#Features) - [FAQ](#faq) - [Known issues](#known-issues) +- [Command Summary](#command-summary) # Glossary @@ -46,9 +47,14 @@ Here are some descriptions of the words we use throughout the User Guide: - What it does: Add potential leads and their basic information, e.g. name, age, year of study, major, etc. - Command format: `addlead n/NAME p/PHONE e/EMAIL a/ADDRESS k/KEY_MILESTONE [m/MEETING_TIME] [t/TAG]...`. - Example usage: `Example: addlead n/John Doe p/98765432 e/johnd@example.com a/311, Clementi Ave 2, #02-25 k/01/12/2023 m/10/10/2023 14:30 t/classmate`. + + Duplicate names are not allowed in the record. The system will prevent the entry of the same name for more than once. + + - Acceptable values for each compulsory parameter: - `NAME`: can contain any string of alphanumeric characters. - The name can contain spaces but cannot be blank (only contain spaces). + - Names are case-sensitive. This means that "John" and "john" are treated as different names, and you can enter both in the record without any issues. - `PHONE`: any valid 8-digit integer, at least 3 digits long. - `EMAIL`: a string of the format `local-part@domain` - The local-part should only contain alphanumeric characters and these special characters, excluding the parentheses, (+_.-). @@ -84,9 +90,15 @@ Example: addlead n/John Doe p/98765432 e/johnd@example.com a/311, Clementi Ave 2 - What it does: Add potential clients and their basic information, e.g. name, age, year of study, major, etc. - Command format: `addclient n/NAME p/PHONE e/EMAIL a/ADDRESS [m/MEETING_TIME] [t/TAG]...`. - Example usage: `Example: addclient n/John Doe p/98765432 e/johnd@example.com a/311, Clementi Ave 2, #02-25 m/10/10/2023 14:30 t/classmate`. + + + Duplicate names are not allowed in the record. The system will prevent the entry of the same name for more than once. + + - Acceptable values for each compulsory parameter: - `NAME`: can contain any string of alphanumeric characters. - The name can contain spaces but cannot be blank (only contain spaces). + - Names are case-sensitive. This means that "John" and "john" are treated as different names, and you can enter both in the record without any issues. - `PHONE`: any valid 8-digit integer, at least 3 digits long. - `EMAIL`: a string of the format `local-part@domain` - The local-part should only contain alphanumeric characters and these special characters, excluding the parentheses, (+_.-). @@ -282,11 +294,21 @@ Example: deletemeeting 1 ### Edit - -- What it does: Edit the details of a lead or client. +- What it does: Edit the details of a lead or a client. - Command format: `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [k/KEY_MILESTONE] [t/TAG]...` + + + Duplicate names are not allowed in the record. The system will prevent the entry of the same name for more than once. + + - Example usage: `edit 1 n/John Doe p/98765432` + + + This command will clear the tags of a lead or client. + + +

Before using edit

@@ -394,8 +416,7 @@ from current date to ensure a follow-up by the user. 1. Open the command prompt 1. Navigate to the directory where the JAR file is located using cd [JAR file location] -//fix this -1. Type `java -jar dave.jar` and press enter +1. Type `java -jar DAVE.jar` and press enter 1. Dave should launch **Q**: How can I check my Java version? From 4f986e0dfe5483246f2fbe6eab926036e92fe986 Mon Sep 17 00:00:00 2001 From: tiif Date: Wed, 8 Nov 2023 18:28:34 +0800 Subject: [PATCH 3/3] Update UG --- docs/_markbind/layouts/default.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/_markbind/layouts/default.md b/docs/_markbind/layouts/default.md index b6eae2d30a2..6e221df3d23 100644 --- a/docs/_markbind/layouts/default.md +++ b/docs/_markbind/layouts/default.md @@ -30,7 +30,7 @@ * [Quick Start]({{ baseUrl }}/UserGuide.html#quick-start) * [Features]({{ baseUrl }}/UserGuide.html#features) * [FAQ]({{ baseUrl }}/UserGuide.html#faq) - * [Command Summary]({{ baseUrl }}/UserGuide.html#faq) + * [Command Summary]({{ baseUrl }}/UserGuide.html#command-summary) * [Developer Guide]({{ baseUrl }}/DeveloperGuide.html) :expanded: * [Acknowledgements]({{ baseUrl }}/DeveloperGuide.html#acknowledgements) * [Setting Up]({{ baseUrl }}/DeveloperGuide.html#setting-up-getting-started)