Skip to content

Commit 7803035

Browse files
authored
Merge pull request #276 from p-xp/update-ug
UG: Update Quick Start and FAQ sections
2 parents cd2c663 + 4db6fbd commit 7803035

File tree

5 files changed

+119
-74
lines changed

5 files changed

+119
-74
lines changed

docs/UserGuide.md

Lines changed: 36 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -129,13 +129,17 @@ If you would like a detailed look into each of the features WedLog has to offer,
129129

130130
## 2. Getting Started
131131

132-
1. Ensure you have Java `11` or above installed in your Computer.
132+
1. Ensure you have Java version `11` or above installed in your Computer.
133+
- You may refer to [this guide](https://blog.hubspot.com/website/check-java-verison) to check the Java version running on your computer.
134+
- If your computer is not running Java version `11` or above, you may refer to these guides ([Windows](https://www.codejava.net/java-se/download-and-install-java-11-openjdk-and-oracle-jdk), [Mac](https://java.tutorials24x7.com/blog/how-to-install-java-11-on-mac))
135+
for instructions on how to install Jave version `11` on your computer.
133136

134-
2. Download the latest `wedlog.jar` from [here](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases).
135137

136-
3. Copy the file to the folder you want to use as the _home folder_ for your WedLog.
138+
2. Download the latest `wedlog.jar` file by clicking [here](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases/download/v1.4/wedlog.jar).
137139

138-
4. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar wedlog.jar` command to run the application.<br>
140+
3. Move the `wedlog.jar` file to the folder you want to use as the home folder for WedLog. You are encouraged to create a new folder specifically for WedLog and to move the `wedlog.jar` file into that folder. All data created by WedLog will be stored in this folder.
141+
142+
4. Open the WedLog application by double-clicking on the `wedlog.jar` file. If this does not work, [open your computer's terminal](https://towardsdatascience.com/a-quick-guide-to-using-command-line-terminal-96815b97b955), [navigate to the folder](https://tutorials.codebar.io/command-line/introduction/tutorial.html) containing `wedlog.jar`, and type `java -jar wedlog.jar` to start the application.
139143

140144
5. A window similar to the one below should appear in a few seconds. Note how the app contains some sample data.
141145

@@ -974,12 +978,39 @@ Upon exit, the latest data is saved to your computer at `data/addressbook.json`.
974978
--------------------------------------------------------------------------------------------------------------------
975979

976980
## 6. FAQ
981+
<!--@@author p-xp-adapted from https://ay2324s1-cs2103t-w11-2.github.io/tp/UserGuide.html#faq-->
977982

978983
**Q**: How do I transfer my data to another Computer?<br>
979-
**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 AddressBook home folder.
984+
**A**: Install WedLog on the other computer and replace the data file it creates with your existing data file. This data file
985+
can be located in your existing WedLog home folder.
986+
987+
<br />
988+
989+
**Q**: Is there somewhere I can refer to all the commands at one glance?<br>
990+
**A**: You may refer to our [command summary](#9-command-summary) section for a quick overview of all the commands available in WedLog.
980991

981992
<br />
982993

994+
**Q**: I accidentally deleted my data file. How can I recover my lost data?<br>
995+
**A**: Please try looking for the deleted file in your computer's recycle bin. Once located, simply move the file from the recycle bin into the same folder as the `wedlog.jar` file.
996+
Unfortunately, in the event that you cannot locate the deleted file in your recycle bin, we are
997+
unable to help you recover your lost data.
998+
999+
<br />
1000+
1001+
**Q**: Can I use WedLog without an internet connection?<br>
1002+
**A**: Yes, the WedLog application does not require internet connection to run.
1003+
1004+
<br />
1005+
1006+
**Q**: My wedding is over. How can I remove WedLog from my computer?<br>
1007+
**A**: We hope you had a good wedding planning journey with WedLog! If you placed WedLog inside a dedicated folder during the installation process,
1008+
simply delete the entire folder. Otherwise, you will have to find and delete the following files individually: `wedlog.jar`, `addressbook.log.0`, `preferences.json`, `config.json`, alongside the `data` folder.
1009+
1010+
<br />
1011+
1012+
> [Back to top](#user-guide)
1013+
9831014
--------------------------------------------------------------------------------------------------------------------
9841015

9851016
## 7. Known Issues

docs/team/keaganpzh.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Given below are my contributions to the project.
5454
* Set up Codecov to track code coverage. [\#1](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/1)
5555
* Managed releases `v1.2`, `v1.3(trial)`, `v1.3`.
5656

57-
### Contributions beyond the Project Team
57+
### Community
5858
* **PE-D**:
5959
* Identified and published [9 issues](https://github.com/keaganpzh/ped) to another team's repository.
6060

docs/team/p-xp.md

Lines changed: 32 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -3,47 +3,58 @@ layout: default.md
33
title: "Pan Xinping's Project Portfolio Page"
44
---
55

6-
# Overview
6+
### Project: WedLog
77

88
WedLog is a desktop application created for partners getting married that helps them manage the guests and vendors involved in the wedding.
99
The user interacts with it using a CLI, and it has a GUI created with JavaFX.
1010
It is written in Java, and has about 10 kLoC. This project is based on [AddressBook - Level 3](https://se-education.org/addressbook-level3/).
1111

1212
Given below are my contributions to the project.
1313

14-
* **New Feature**: Added the ability to add guests and vendors.
14+
### Features
15+
1. **New Feature**: Added the ability to add guests and vendors.
1516
* What it does: Allows users to add new guests and vendors with all the associated fields to WedLog.
1617
* Justification: This feature is central to the product as users cannot manage guests and vendors without being able to add them.
1718
* Highlights: The implementation was challenging as guests and vendors had optional fields which users could choose not to fill in.
1819

19-
* **New Feature**: Added the ability to edit guests.
20+
<br>
21+
22+
2. **New Feature**: Added the ability to edit guests.
2023
* What it does: Allows the user to edit fields of a guest.
2124
* Justification: This feature improves the product significantly because a user may want to modify guest information and the app should provide an easy way to do so without having to remove and add the guest back.
2225
* Highlights: The implementation was challenging because guests have optional fields which can be removed by using empty prefixes in the edit command. This required a careful consideration of design alternatives.
2326

24-
* **New Feature**: Added the ability to filter guests by fields that stored information as tags (i.e., Dietary Requirements and Tags fields).
27+
<br>
28+
29+
3. **New Feature**: Added the ability to filter guests by fields that stored information as tags (i.e., Dietary Requirements and Tags fields).
2530
* What it does: Allows users to filter all guests using tag fields.
2631
* Justification: This feature improves the product significantly as users may want to view all users that belong to a certain category (e.g. "vegans", or "classmates") without searching for them individually.
2732
* Highlights:
2833
* The implementation was challenging as unlike non-tag fields, tag fields can store multiple values (e.g. a guest may have two Dietary Requirements tags). Hence, there was a need to carefully consider use cases to decide on the final design where users can filter via multiple tags.
2934
* Ensured high test effectiveness and efficiency by applying test heuristics like equivalence partitions to test designs (see `TagPredicateTest` and `GuestDietaryPredicateTest`).
3035

31-
* **Code contributed**: [RepoSense link](https://nus-cs2103-ay2324s1.github.io/tp-dashboard/?search=p-xp&breakdown=true)
32-
33-
* **Contribution to team tasks**:
34-
* Organised team meeting agenda based on weekly deliverables and tracked list of TODOs determined during team discussions.
35-
* Allocated issues identified in PED to team members on GitHub.
36-
37-
* **Documentation**:
38-
* User Guide:
39-
* Added documentation for `guest edit` [\#127](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/127)
40-
* Updated documentation for `guest add` [\#105](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/105), `vendor add` [\#106](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/106), and`guest filter` [\#153](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/153)
41-
* Developer Guide:
42-
* Added implementation details of the `add` feature [\#150](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/150), [\#268](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/268)
43-
* Wrote Appendix D: Effort [\#268](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/268)
44-
45-
* **Community**:
46-
* PRs reviewed (with non-trivial review comments): [\#41](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/41), [\#142](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/142)
47-
* Reported [17 bugs and suggestions](https://github.com/p-xp/ped/issues) for other teams
36+
### Code Contributed
37+
[RepoSense link](https://nus-cs2103-ay2324s1.github.io/tp-dashboard/?search=p-xp&breakdown=true)
38+
39+
### Documentation
40+
* User Guide:
41+
* Added documentation for `guest edit`: [\#127](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/127)
42+
* Updated documentation for `guest add`: [\#105](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/105)
43+
* Updated documentation for `vendor add`: [\#106](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/106)
44+
* Updated documentation for `guest filter`: [\#153](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/153)
45+
* Enhanced Quick Start and FAQ sections: [\#276](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/276)
46+
* Credits: FAQ section was partially adapted from [AY2324S1-CS2103T-W11-2](https://github.com/AY2324s1-cs2103t-w11-2/tp/).
47+
* Developer Guide:
48+
* Added implementation details of the `add` feature: [\#150](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/150), [\#268](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/268)
49+
* Wrote Appendix D Effort: [\#268](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/268)
50+
51+
### Contributions to team tasks
52+
* Organised team meeting agenda based on weekly deliverables and tracked deadlines determined during team discussions.
53+
* Allocated issues identified in PED to team members on GitHub.
54+
* Managed release `v1.4`.
55+
56+
### Community
57+
* PRs reviewed (with non-trivial review comments): [\#41](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/41), [\#142](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/142)
58+
* Reported [17 bugs and suggestions](https://github.com/p-xp/ped/issues) for other teams
4859

4960

docs/team/samuelim01.md

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -9,28 +9,26 @@ WedLog is a desktop application created for partners getting married that helps
99

1010
Given below are my contributions to the project.
1111

12-
* **New Feature**: Modified some fields to be optional for guests and vendors.
13-
* What it does: allows the user to leave optional fields empty for guests and vendors.
14-
* Justification: This feature improves the product significantly because a user may not want to specify all the fields of a guest or vendor, and the app should provide the flexibility for the user to do so.
15-
* Credits: Partially adapted from [AY2324S1-CS2103T-W08-3](https://github.com/AY2324S1-CS2103T-W08-3/tp/).
16-
17-
* **New Feature**: Added the ability to edit vendors.
18-
* What it does: allows the user to edit fields of a vendor.
19-
* Justification: This feature improves the product significantly because a user may want to modify vendor information and the app should provide an easy way to do so without having to remove and add back the vendor.
20-
* Highlights: The implementation was challenging because vendors have optional fields which can be removed by using empty prefixes in the edit command. This required a careful consideration of design alternatives.
21-
22-
* **New Feature**: Added the ability to undo/redo previous commands.
23-
* What it does: allows the user to undo all previous commands one at a time. Preceding undo commands can be reversed by using the redo command.
24-
* Justification: This feature improves the product significantly because a user can make mistakes in commands and the app should provide a convenient way to rectify them.
25-
* Credits: Adapted from [AddressBook Level-4](https://github.com/se-edu/addressbook-level4).
26-
27-
* **Code contributed**: [RepoSense link](https://nus-cs2103-ay2324s1.github.io/tp-dashboard/?search=samuelim01&breakdown=true)
28-
29-
* **Project management**:
30-
* Renamed `seedu` package to `wedlog` : [\#96](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/96)
31-
* Managed releases `v1.1` - `v1.1.1` (2 releases: [1](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases/tag/v1.1), [2](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases/tag/v1.1.1)) on GitHub
32-
33-
* **Documentation**:
12+
### Features
13+
1. **New Feature**: Modified some fields to be optional for guests and vendors.
14+
* What it does: allows the user to leave optional fields empty for guests and vendors.
15+
* Justification: This feature improves the product significantly because a user may not want to specify all the fields of a guest or vendor, and the app should provide the flexibility for the user to do so.
16+
* Credits: Partially adapted from [AY2324S1-CS2103T-W08-3](https://github.com/AY2324S1-CS2103T-W08-3/tp/).
17+
18+
2. **New Feature**: Added the ability to edit vendors.
19+
* What it does: allows the user to edit fields of a vendor.
20+
* Justification: This feature improves the product significantly because a user may want to modify vendor information and the app should provide an easy way to do so without having to remove and add back the vendor.
21+
* Highlights: The implementation was challenging because vendors have optional fields which can be removed by using empty prefixes in the edit command. This required a careful consideration of design alternatives.
22+
23+
3. **New Feature**: Added the ability to undo/redo previous commands.
24+
* What it does: allows the user to undo all previous commands one at a time. Preceding undo commands can be reversed by using the redo command.
25+
* Justification: This feature improves the product significantly because a user can make mistakes in commands and the app should provide a convenient way to rectify them.
26+
* Credits: Adapted from [AddressBook Level-4](https://github.com/se-edu/addressbook-level4).
27+
28+
### Code Contributed
29+
[RepoSense link](https://nus-cs2103-ay2324s1.github.io/tp-dashboard/?search=samuelim01&breakdown=true)
30+
31+
### Documentation
3432
* User Guide:
3533
* Added documentation for the features `vendor add` and `vendor delete`: [\#40](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/40/)
3634
* Added documentation for the features `undo` and `redo`: [\#121](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/121)
@@ -42,6 +40,10 @@ Given below are my contributions to the project.
4240
* Added implementation details for the feature `edit`: [\#149](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/149)
4341
* Updated Appendix B: [\#262](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/262)
4442

45-
* **Community**:
43+
### Contributions to team tasks
44+
* Renamed `seedu` package to `wedlog` : [\#96](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/96)
45+
* Managed releases `v1.1` - `v1.1.1` (2 releases: [1](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases/tag/v1.1), [2](https://github.com/AY2324S1-CS2103T-F11-2/tp/releases/tag/v1.1.1)) on GitHub
46+
47+
### Community
4648
* PRs reviewed (with non-trivial review comments): [\#116](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/116), [\#127](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/127), [\#129](https://github.com/AY2324S1-CS2103T-F11-2/tp/pull/129)
4749
* Reported [bugs and suggestions](https://github.com/samuelim01/ped/issues) for other teams

0 commit comments

Comments
 (0)