Skip to content
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

Open
wants to merge 394 commits into
base: master
Choose a base branch
from

Conversation

raniceyue
Copy link

@zsoh97
Copy link

zsoh97 commented Feb 24, 2020

Update UserGuide.adoc

@raniceyue raniceyue force-pushed the master branch 4 times, most recently from 569da94 to 3ff2c25 Compare February 28, 2020 12:33

|`* * *` |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| ??
Copy link

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

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

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


[none]
* 1a. V detects invalid characters in trip details
* 1a1. V outputs error informing user of invalid characters

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

*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

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)


|`* *` |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
Copy link

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 ... |

Comment on lines 385 to 389
**Guarantee: **Information of existing trip will be changed

*MSS*

1. User requests to edit trip at specified index
Copy link

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)

[discrete]
=== UC03 - Accessing a Trip Folder

*Precondition:* User is in the hope page and the trip to access exists

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)

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
Copy link

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


|`* * *` |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
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

*duration?

[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
Copy link

@alcen alcen Mar 6, 2020

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


[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.

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

Copy link

@nathanaelseen nathanaelseen left a 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!


[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.

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

|=======================================================================
|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 ...

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

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)


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.

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.


.Component interactions for `delete 1` command
.Component interactions for `back` command in the `TRIP` view.
image::ArchitectureSequenceDiagram.png[]
Copy link

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.


[[Design-Ui]]
=== UI component

.Structure of the UI Component
image::UiClassDiagram.png[]
image::UIClassDiagram.png[]
Copy link

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?



.Class Diagram of the Journal Logic Component
image::JournalLogicDiagram.png[]

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

zsoh97 and others added 30 commits April 13, 2020 21:12
* 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.