diff --git a/docs/UserGuide.md b/docs/UserGuide.md index a485344bba3..341d1f754f7 100644 --- a/docs/UserGuide.md +++ b/docs/UserGuide.md @@ -5,18 +5,23 @@ pageNav: 3 --- # [Ba]king [Br]ead User Guide -Welcome! If you are a new baker suffering under the mess and stress of baking, [Ba]king [Br]ead is here to help organise -your kitchen and recipes. +Welcome new bakers! +If you're feeling overwhelmed by the chaos of baking, fret not because [Ba]king [Br]ead is here to save the day! +We're here to help you manage the overwhelming number of ingredients in your kitchen and the endless recipes you have stored, +making your baking experience a lot smoother! [Ba]king [Br]ead will help you to: 1. Keep track of all your baking ingredients in your kitchen -2. Collate all your recipes digitally for easy viewing -3. Do all the above with blazing efficiency, your fast fingers and our application's command line interface makes this -uniquely possible. +2. Collate all your recipes digitally for easy viewing +3. Achieve maximum efficiency -You will never forget what Ingredient you need to stock up on during your next trip to the supermarket. You will never -have to flip through heavy physical recipe books any longer. What are you waiting for? Master [Ba]king [Br]ead and -fast-track your baking journey now! +Our application's command-line interface, coupled with your fast fingers, makes baking a whole lot more seamless and relaxing! + +Long gone are the days when you have to rummage through your cupboards to see what you have. Now with [Ba]king [Br]ead, +you will never forget what ingredient you need to stock up on during your next trip to the supermarket. And now, you will never +have to flip through endless heavy physical recipe books just to find a recipe you like. + +So, what are you waiting for? Master [Ba]king [Br]ead and fast-track your baking journey now! ## Using this Guide This user guide contains all the information you will need in order to use [Ba]king [Br]ead. For new users, this document will also guide you in using the application, @@ -59,7 +64,6 @@ Used to highlight errors to look out for -------------------------------------------------------------------------------------------------------------------- ## Table of Contents -* [Using this Guide](#using-this-guide) * [Glossary](#glossary) * [Getting Started](#quick-start) * [Navigating the GUI](#navigating-the-gui) @@ -83,6 +87,18 @@ Used to highlight errors to look out for
+## Glossary +Listed below are the definitions of the terminology used throughout the User Guide + +| Term | Definition | +|:-------------------------------------|:----------------------------------------------------------------------------------------------------------------| +| GUI (Graphical User Interface) | The visual interface of [Ba]king [Br]ead | +| Command | A set of words that execute a certain operation | +| Parameter | Key information that a user specifies in a command | +| UUID (Universally Unique IDentifier) | A unique number that is used to identify the recipes | +| Case-insensitive | Parameters are not treated differently if they are in capitals or lower-case text. Eg. MILK is the same as milk | + + ## Quick start New to [Ba]king [Br]ead? Not to worry, simply follow the instructions below to get started! @@ -93,8 +109,9 @@ New to [Ba]king [Br]ead? Not to worry, simply follow the instructions below to g 3. Copy the file to the folder you want to use as the _home folder_ for [Ba]king [Br]ead. -4. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar bakingbread.jar` command to run the application.
- A GUI similar to the one below should appear in a few seconds. Note how the app contains some sample data. +4. Double-click on the jar and a GUI similar to the one below should appear in a few seconds. If this does not work for you, check the [FAQ](#faq) + +![Ui](images/Ui.png) ### Navigating the GUI The GUI may be confusing if you are a first time user of our application. Here is the breakdown of the GUI for [Ba]king [Br]ead. @@ -152,7 +169,7 @@ Refer to the [Features](#features) below for details of the other commands avail * Parameters can be in any order.
e.g. if the command specifies `n/NAME q/QUANTITY`, `q/QUANTITY n/NAME` is also acceptable. -* Parameters are case-insensitive. +* Parameters are not case-sensitive. e.g. A parameter specified as `n/Milk` is functionally identical to `n/MILK` or `n/milk`. * Extraneous parameters for commands that do not require parameters (such as `help`, `exit` , `list` and `clear`) will be ignored.
@@ -182,10 +199,10 @@ Refer to the [Features](#features) below for details of the other commands avail If you are not sure how to use [Ba]king [Br]ead, this command will show a pop-up with a link to access the help page. - - Format: `help` + +
### Adding an ingredient: `add` @@ -212,10 +229,12 @@ Example Used: `add n/Flour q/1 u/kg` **Note**: Sample started with 3kg of Flour + Example Used: `add n/Milk q/600 u/g` **Note**: Sample did not have any Milk in the stock. + ### Using up ingredients : `use` Depletes a specified quantity of an ingredient from the stock. @@ -224,7 +243,7 @@ Format: `use n/NAME [q/QUANTITY] [u/UNIT]` * If no quantity and unit is specified, the entire stock of the specified ingredient will be depleted. * If the quantity depleted exceeds the current quantity in stock, the entire stock will be depleted but will not go into the negative. -* Note that the specified name **must** be exact. As such, `use butters` will not work if the ingredient list contains `butter`. +* Note that the specified name **must** be exact. As such, `use n/butters` will not work if the ingredient list contains `butter`. Restrictions: * Unit specified must be supported. @@ -243,9 +262,10 @@ Example Used: `use n/Milk q/600 u/g` **Note**: Sample started with 1kg of Milk i + -If you try to use an ingredient which is not in the stock, the error message `Ingredient does not exist in Inventory` will appear.
-Only ingredients in stock can be specified when using this command. +If you try to use an ingredient which is not in the stock, the error message "Ingredient does not exist in Inventory" will appear.
+Only ingredients already in the stock can be specified when using this command. ### Finding the quantity of an ingredient by name: `stock` @@ -270,6 +290,7 @@ Example used: `stock butter` + ### Clearing all ingredients from ingredient stock : `clear` Clears all ingredients from the ingredient stock. @@ -280,6 +301,7 @@ Example used: `clear` + ### Listing all Recipes : `list` Lists all recipes that are currently stored in [Ba]king [Br]ead. @@ -290,8 +312,6 @@ Example Used: `list` -Examples: -* `list` lists out all recipes within [Ba]king [Br]ead. ### Viewing Specific Recipes : `view` @@ -309,6 +329,13 @@ Example Used: `view 1` + + +**Note:** +Only recipes that are currently in the recipe list can be viewed. + + + ### Adding Recipes : `addrecipe` Adds a new recipe to the recipe book. Each line in this command should be entered one by one. @@ -362,7 +389,7 @@ When encountering the error message `Failed to add step`, ensure that the index( Example: `1. Mix Water and Flour` **Note**: Ensure that a period and space is present after the index. - + **Caution:** As this function relies heavily on the user's input, please do check that your input is of the correct format. @@ -380,13 +407,6 @@ Example: * Assuming flour is used in the recipe, `modify i/1 n/Flour q/100 u/g` modifies the `Flour` ingredient in the recipe to 100 grams of flour. * Assuming flour is not used in the recipe, `modify i/1 n/Flour q/100 u/g` adds the 100 grams of the `Flour` ingredient to the recipe. - - - -**Note**: After a recipe has been modified, it will be pushed to the bottom of the recipe list. - - - Example Used: `modify i/1 n/Flour q/100 u/g` **Note**: Recipe being modified has 200g of flour as part of the ingredient list @@ -399,6 +419,18 @@ Example Used: `modify i/1 n/Cream q/100 u/g` + + +**Note:** +Only recipes that are currently in the recipe list can be modified. + + + + +**Note**: After a recipe has been modified, it will be pushed to the bottom of the recipe list. + + + ### Deleting Recipes : `delete` Deletes a specific recipe from [Ba]king [Br]ead when you longer need it. @@ -412,6 +444,12 @@ Examples: * `delete 1` deletes the recipe with `UUID` of 1. * `delete 21` deletes the recipe with `UUID` of 21. + + +**Note:** +Only recipes that are currently in the recipe list can be deleted. + + ### Searching Recipes given an ingredient: `search` Searches for recipes that include a specific ingredient. @@ -437,6 +475,7 @@ Example used: `search blueberry`: **Note**: Only one recipe uses the ingredient + ### Exiting the program : `exit` Exits the program. @@ -453,7 +492,7 @@ Inventory and Recipe data are saved in the hard disk automatically after any com Inventory data are saved automatically as a JSON file `[JAR file location]/data/inventory.json`. Advanced users are welcome to update data directly by editing that data file. - + **Caution:** If your changes to the data file makes its format invalid, Inventory will discard all data and start with an empty data file at the next run. Hence, it is recommended to take a backup of the file before editing it. @@ -463,13 +502,14 @@ If your changes to the data file makes its format invalid, Inventory will discar ### Common Possible Errors -| Error Message | What to do | -|-----------------------------------|---------------------------------------| -| Unknown command | Ensure that the command keyed in is one of the commands mentioned within this document| -| Invalid Command Format | Ensure that all parameters have keyed in and that none are left empty| -| Names should only contain alphanumeric characters and spaces, and it should not be blank | Ensure that only letters and numbers are used for names | -| Quantity has to be positive | Ensure that the quantity valued keyed in is **greater** than 0 | -| There is no recipe with the recipe UUID provided in the recipe book | Check the UUID of recipe attempting to use and ensure that it is correct| +| Error Message | What to do | +|-----------------------------------|----------------------------------------------------------------------------------------| +| Unknown command | Ensure that the command keyed in is one of the commands mentioned within this document | +| Invalid Command Format | Ensure that all parameters have keyed in and that none are left empty | +| Names should only contain alphanumeric characters and spaces, and it should not be blank | Ensure that only letters and numbers are used for names | +| Quantity has to be positive | Ensure that the quantity valued keyed in is **greater** than 0 | +| There is no recipe with the recipe UUID provided in the recipe book | Check the UUID of recipe attempting to use and ensure that it is correct | +| The recipe UUID provided is invalid | Ensure that the UUID you have entered is valid (ie. it is a positive integer | -------------------------------------------------------------------------------------------------------------------- @@ -478,6 +518,10 @@ If your changes to the data file makes its format invalid, Inventory will discar **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 [Ba]king [Br]ead home folder. +**Q**: The application does not run when I double-click it!
+**A**: First, check if you have Jave `11` installed in your computer. If you do and still have issues, try this: Open a command terminal, `cd` into the +folder you put the jar file in, and use the `java -jar bakingbread.jar` command to run the application.
+ -------------------------------------------------------------------------------------------------------------------- ## Command summary