-
Notifications
You must be signed in to change notification settings - Fork 65
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
[T10-3] LearnVocabulary #109
base: master
Are you sure you want to change the base?
[T10-3] LearnVocabulary #109
Conversation
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.
Overall:
Good job on meeting all requirements for the v1.1 team component. However, some areas need more work. Hope you can tackle those areas in upcoming features.
Some detailed feedback:
- ReadMe adoc
- Product description still refers to AB-4's functionality (point 2).
- Describe what LearnV is in the homepage
- Remove top SE EDU nav bar and link to LOs
-
View on GitHub link
Results in 404. Check that you have correctly followed the steps for auto-publishing of docs -
Contact Us adoc
Details have to be updated -
About Us adoc
- Photos aren't visible. Please update ASAP.
- Developer Guide adoc
- Looks like the auto publish is not properly enabled. The page is all cluttered up and not being displayed in the correct manner.
- Two groups of Group User stories provided. Use either one, preferably the one grouped by priority
- Use case steps are too complex and not atomic. Suggest splitting up into multiple steps as in the comment provided.
docs/DeveloperGuide.adoc
Outdated
. Go to `File` > `Settings...` (Windows/Linux), or `IntelliJ IDEA` > `Preferences...` (macOS) | ||
. Select `Editor` > `Code Style` > `Java` | ||
. Click on the `Imports` tab to set the order | ||
System checks if word exists in the dictionary and displays if the word could be successfully added or not. It also displays the meaning of the word. |
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.
Too many steps in this one line. Ideally it should be split up as the MSS and the exception workflow. Something like:
MSS:
- User enters a word to add to the review list.
- System adds word to the dictionary.
- System prompts user with word successfully added message
- System displays newly added word's meaning
Use case ends
Extensions:
2a. Word already exists in the dictionary
2a1. System prompts user with word already exists message
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.
Noted: Individual Progress: |
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.
Feedback for v1.2
Read Me ascii doc
- The Introduction section refers to a Section 2, “Quick Start” which is not part of Read Me, but in User guide. Update description
User guide ascii doc
- Use better descriptions for what each command does. Some of them are not very clear. For e.g. Group words. The description reads group words accordingly. According to what?
Developer guide ascii doc
- If a feature is not implemented, you can mark it as coming in v2.0
- User stories are repeated twice. Use the version in the Appendix as they are prioritised.
Overall
- Good effort. Work on getting the product to a user-testable state by v1.3
- Catch up on documentation work. Good job adding some design descriptions, but not enough new UML diagrams to give feedback on your UML modeling skills. Try to add more soon.
Added tests for trivia command and updates to browser panel.
… other things in Dev guide
Add description on Word of The Day in Developer guide.
Added trivia testing instructions
no message
no message
(replaced basic tag with group tag) - for @Harryqu123
fix bugs in alexehrs PPP
Bug fixes alexehrs PPP
Travis Build is still failing - even before coding, needs a little more attention.
Code wise:
Changes implemented - dictionary function, add/find, grouping and trivia
Comments:
Dictionary has been fully worked out, just needs to be integrated, will probably need a lot of debugging.
Add/find, grouping and trivia has a few bugs
Also, we are aware of some discrepencies in the naming of our document and will address that by next week! We will also update the author's name as well.