-
Notifications
You must be signed in to change notification settings - Fork 263
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[CS2103T-F09-4] Volant #18
base: master
Are you sure you want to change the base?
[CS2103T-F09-4] Volant #18
Conversation
Update UserGuide.adoc |
569da94
to
3ff2c25
Compare
docs/DeveloperGuide.adoc
Outdated
|
||
|`* * *` |user |find a person by name |locate details of persons without having to go through the entire list | ||
|`* *` |frequent traveler |to be able to see a timeline view of all my short journal entries and photos, including the location and time of the photos and entries, per trip| ?? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hellooo, you might have forgotten to add some content. Might in something in v2.0
|
||
|`* * *` | traveler always on the go | record short text entries recording my travels, similar to that of a Tweet on Twitter | can keep track of my activities without excessive typing | ||
|
||
|`* * *` |user |add an activity into an itinerary list |see my planned activities at a glance and better plan my trip |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
May want to specify "user" to a more specific target user (i.e. solo traveler, CLI enthusiast)
|`* *` |user |hide <<private-contact-detail,private contact details>> by default |minimize chance of someone else seeing them by accident | ||
|`* *` |food lover |add a meal with description, photo, price and location |keep track of what I ate | ||
|
||
|`* *` |user |sort my travel entries by category depending on the ‘feeling’ tag of each travel entry |see my best moments |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
How do you define best moments? You could list the categories here
docs/DeveloperGuide.adoc
Outdated
|
||
[none] | ||
* 1a. V detects invalid characters in trip details | ||
* 1a1. V outputs error informing user of invalid characters |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Indentation of details of extensions (e.g. 1a1., 1a2...) should be indented
docs/DeveloperGuide.adoc
Outdated
*MSS* | ||
|
||
1. User enters details of trip to be added | ||
2. V writes added trip into data files and displays new trip in the trip list |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Use Cases should not specify what goes behind the scenes of your System (specifically adding trip into data files)
docs/DeveloperGuide.adoc
Outdated
|
||
|`* *` |user |sort my travel entries by category depending on the ‘feeling’ tag of each travel entry |see my best moments | ||
|
||
|`* *` |busy user |list and record items in a packing list |easily reference what I need for a trip at a glance |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It might be better to split this into two different use cases (follow Single Responsibility Principle of User Stories)
So for example
| busy user |list items ... |
| busy user | record items ... |
docs/DeveloperGuide.adoc
Outdated
**Guarantee: **Information of existing trip will be changed | ||
|
||
*MSS* | ||
|
||
1. User requests to edit trip at specified index |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might need to list the trips first (assuming user starts with a blank slate)
docs/DeveloperGuide.adoc
Outdated
[discrete] | ||
=== UC03 - Accessing a Trip Folder | ||
|
||
*Precondition:* User is in the hope page and the trip to access exists |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Typo for home page!
|
||
*MSS* | ||
|
||
1. User navigates to a specific trip (UC03) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remember to underline the inclusion of other use cases. (Following the textbook's format)
|Priority |As a ... |I want to ... |So that I ca ... | ||
|`* * *` | frequent traveler | add a travel entry with weather, location and time metadata | document my past travels | ||
|
||
|`* * *` | traveler always on the go | record short text entries recording my travels, similar to that of a Tweet on Twitter | can keep track of my activities without excessive typing |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure what short text entries have to do with excessive typing
docs/DeveloperGuide.adoc
Outdated
|
||
|`* * *` |user |edit the entries in my itinerary list |can amend any mistakes when entering data, or change my travel plans | ||
|
||
|`* * *` |user | see a chronological timeline of the activities in the itinerary | can have a clear idea of my travel plans and schedule dur |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
*duration?
docs/DeveloperGuide.adoc
Outdated
[none] | ||
1. User requests to delete a contact in the contact list at the specified index | ||
2. V deletes the contact at the specified index and display the new contact list | ||
3. Use case ends |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably "use case ends" shouldn't be part of the list here, to standardise with previous use cases
docs/DeveloperGuide.adoc
Outdated
|
||
[appendix] | ||
== Non Functional Requirements | ||
|
||
. Should work on any <<mainstream-os,mainstream OS>> as long as it has Java `11` or above installed. | ||
. Should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage. | ||
. Should be able to hold up to 100 trips without a noticeable sluggishness in performance for typical usage. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can specify what is "noticeable sluggishness". e.g. no lags > 1 second
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I feel that overall the docs are quite good quality, just a few minor things to note!
docs/DeveloperGuide.adoc
Outdated
|
||
[appendix] | ||
== Non Functional Requirements | ||
|
||
. Should work on any <<mainstream-os,mainstream OS>> as long as it has Java `11` or above installed. | ||
. Should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage. | ||
. Should be able to hold up to 100 trips without a noticeable sluggishness in performance for typical usage. | ||
. 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Average typing speed not quite specific
docs/DeveloperGuide.adoc
Outdated
|======================================================================= | ||
|Priority |As a ... |I want to ... |So that I can... | ||
|`* * *` |new user |see usage instructions |refer to instructions when I forget how to use the App | ||
|Priority |As a ... |I want to ... |So that I ca ... |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(trivial: small typo for 'can')
*MSS* | ||
|
||
1. User navigates to a specific trip (UC03) | ||
2. User requests to navigate to the desired page in current trip |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
hi! to add on, as we should alternate User
and V
, instead of having 2 consecutive User
(rationale: use-case diagram shows user-system interaction)
docs/DeveloperGuide.adoc
Outdated
|
||
The _Sequence Diagram_ below illustrates how the components iteract with each other for the scenario where the user issues the command `goto 1` when in a `HomePage` view. | ||
|
||
.Component interactions for `goto 1` command in the `HomePage` view. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The "new" can be removed. Method calls should have (). From user to mainwindow, it should be a method call.
docs/DeveloperGuide.adoc
Outdated
|
||
.Component interactions for `delete 1` command | ||
.Component interactions for `back` command in the `TRIP` view. | ||
image::ArchitectureSequenceDiagram.png[] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Constructor call should have (). The "new" keyword is not necessary.
docs/DeveloperGuide.adoc
Outdated
|
||
[[Design-Ui]] | ||
=== UI component | ||
|
||
.Structure of the UI Component | ||
image::UiClassDiagram.png[] | ||
image::UIClassDiagram.png[] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps a little too complicated?
docs/DeveloperGuide.adoc
Outdated
|
||
|
||
.Class Diagram of the Journal Logic Component | ||
image::JournalLogicDiagram.png[] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The arrow for one of the creates i think should be pointing down
Update GUI Update GUI Update GUI Update GUI
Update GUI
* Fix bugs from PR #165 * Update SampleDataUtil.java Fix bug for missing invalid goto command exception on the Trip page * Fix command feedback messages * Fix result display bugs Fix %s bug from returning to trip page from itinerary page Standardize format for result display text for all command usage messages Remove `list` command Fix result display bugs * Implement refresh command * Make elements on home page scroll together * Touch up GUI Update Ui.png * Implement help window for home page Touched up user guide Fix build fail * Add some screenshots to user guide * Fix travis build fail * Update user guide with screenshots * Update user guide with data storage screenshot * Update user guide with data storage screenshot * Update icons in asciidoctor.css * Update tip icon * Fix journal GUI * Remove tutorial images * Update screenshots * Update screenshots * Update screenshots * Add screenshots to user guide * Implement help windows Implement help windows * Fix GUI bugs * Clean up code * Update diagrams in DG * Optimize imports * Fix screenshots in UG * Fix build errors * Fix itinerary delete bug * Remove AB3 diagrams, Add navigation cheatsheet, Update Ranice's PPP * Change width of navigation summary diagram * Fix UG screenshots * Fix GUI bug on HOME page * Update implementation in DG * Add class diagram for home page model * Update sequence diagram in DG * Update DG * Update Ranice's PPP
refactored code where file was deleted in model instead of logic
* Fix bugs from PR #165 * Update SampleDataUtil.java Fix bug for missing invalid goto command exception on the Trip page * Fix command feedback messages * Fix result display bugs Fix %s bug from returning to trip page from itinerary page Standardize format for result display text for all command usage messages Remove `list` command Fix result display bugs * Implement refresh command * Make elements on home page scroll together * Touch up GUI Update Ui.png * Implement help window for home page Touched up user guide Fix build fail * Add some screenshots to user guide * Fix travis build fail * Update user guide with screenshots * Update user guide with data storage screenshot * Update user guide with data storage screenshot * Update icons in asciidoctor.css * Update tip icon * Fix journal GUI * Remove tutorial images * Update screenshots * Update screenshots * Update screenshots * Add screenshots to user guide * Implement help windows Implement help windows * Fix GUI bugs * Clean up code * Update diagrams in DG * Optimize imports * Fix screenshots in UG * Fix build errors * Fix itinerary delete bug * Remove AB3 diagrams, Add navigation cheatsheet, Update Ranice's PPP * Change width of navigation summary diagram * Fix UG screenshots * Fix GUI bug on HOME page * Update implementation in DG * Add class diagram for home page model * Update sequence diagram in DG * Update DG * Update Ranice's PPP * Update AboutUs.adoc and Ranice's PPP
* Updated User Guide according to tutor feedback * Update UG with exit command and correct command summary * Fixed bug in Journal where feeling tag does not show in GUI if user does not provide weather * Add underscore for consistency * Add refresh command to Trip page * Update UML diagrams in DG * Implementation for data storage (DG) and fix spelling error in TripPageItineraryCard * Fix bug where feeling tag does not show in GUI when weather is not provided in Journal * Rearranged DG * Proof-read, review and format UG for v1.4 submission
* Fix bugs from PR #165 * Update SampleDataUtil.java Fix bug for missing invalid goto command exception on the Trip page * Fix command feedback messages * Fix result display bugs Fix %s bug from returning to trip page from itinerary page Standardize format for result display text for all command usage messages Remove `list` command Fix result display bugs * Implement refresh command * Make elements on home page scroll together * Touch up GUI Update Ui.png * Implement help window for home page Touched up user guide Fix build fail * Add some screenshots to user guide * Fix travis build fail * Update user guide with screenshots * Update user guide with data storage screenshot * Update user guide with data storage screenshot * Update icons in asciidoctor.css * Update tip icon * Fix journal GUI * Remove tutorial images * Update screenshots * Update screenshots * Update screenshots * Add screenshots to user guide * Implement help windows Implement help windows * Fix GUI bugs * Clean up code * Update diagrams in DG * Optimize imports * Fix screenshots in UG * Fix build errors * Fix itinerary delete bug * Remove AB3 diagrams, Add navigation cheatsheet, Update Ranice's PPP * Change width of navigation summary diagram * Fix UG screenshots * Fix GUI bug on HOME page * Update implementation in DG * Add class diagram for home page model * Update sequence diagram in DG * Update DG * Update Ranice's PPP * Update AboutUs.adoc and Ranice's PPP * Update Ranice's PPP
* Fix bugs from PR #165 * Update SampleDataUtil.java Fix bug for missing invalid goto command exception on the Trip page * Fix command feedback messages * Fix result display bugs Fix %s bug from returning to trip page from itinerary page Standardize format for result display text for all command usage messages Remove `list` command Fix result display bugs * Implement refresh command * Make elements on home page scroll together * Touch up GUI Update Ui.png * Implement help window for home page Touched up user guide Fix build fail * Add some screenshots to user guide * Fix travis build fail * Update user guide with screenshots * Update user guide with data storage screenshot * Update user guide with data storage screenshot * Update icons in asciidoctor.css * Update tip icon * Fix journal GUI * Remove tutorial images * Update screenshots * Update screenshots * Update screenshots * Add screenshots to user guide * Implement help windows Implement help windows * Fix GUI bugs * Clean up code * Update diagrams in DG * Optimize imports * Fix screenshots in UG * Fix build errors * Fix itinerary delete bug * Remove AB3 diagrams, Add navigation cheatsheet, Update Ranice's PPP * Change width of navigation summary diagram * Fix UG screenshots * Fix GUI bug on HOME page * Update implementation in DG * Add class diagram for home page model * Update sequence diagram in DG * Update DG * Update Ranice's PPP * Update AboutUs.adoc and Ranice's PPP * Update Ranice's PPP * Fix DG bugs
* Fix bugs from PR #165 * Update SampleDataUtil.java Fix bug for missing invalid goto command exception on the Trip page * Fix command feedback messages * Fix result display bugs Fix %s bug from returning to trip page from itinerary page Standardize format for result display text for all command usage messages Remove `list` command Fix result display bugs * Implement refresh command * Make elements on home page scroll together * Touch up GUI Update Ui.png * Implement help window for home page Touched up user guide Fix build fail * Add some screenshots to user guide * Fix travis build fail * Update user guide with screenshots * Update user guide with data storage screenshot * Update user guide with data storage screenshot * Update icons in asciidoctor.css * Update tip icon * Fix journal GUI * Remove tutorial images * Update screenshots * Update screenshots * Update screenshots * Add screenshots to user guide * Implement help windows Implement help windows * Fix GUI bugs * Clean up code * Update diagrams in DG * Optimize imports * Fix screenshots in UG * Fix build errors * Fix itinerary delete bug * Remove AB3 diagrams, Add navigation cheatsheet, Update Ranice's PPP * Change width of navigation summary diagram * Fix UG screenshots * Fix GUI bug on HOME page * Update implementation in DG * Add class diagram for home page model * Update sequence diagram in DG * Update DG * Update Ranice's PPP * Update AboutUs.adoc and Ranice's PPP * Update Ranice's PPP * Fix DG bugs * Fix bug in Ranice's PPP
* Updated User Guide according to tutor feedback * Update UG with exit command and correct command summary * Fixed bug in Journal where feeling tag does not show in GUI if user does not provide weather * Add underscore for consistency * Add refresh command to Trip page * Update UML diagrams in DG * Implementation for data storage (DG) and fix spelling error in TripPageItineraryCard * Fix bug where feeling tag does not show in GUI when weather is not provided in Journal * Rearranged DG * Proof-read, review and format UG for v1.4 submission * Update Grant's PPP * Update DG
@grrrrnt
@mikhailfaiz
@zsoh97
@vuhieunguyen