-
Notifications
You must be signed in to change notification settings - Fork 231
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
[CS2113-T12-1] News on the Go #5
base: master
Are you sure you want to change the base?
[CS2113-T12-1] News on the Go #5
Conversation
…utus Added Samuel Ong About Us
Zong Yao Main master
docs/DeveloperGuide.md
Outdated
|
||
#### Alternatives Considered | ||
- **Cloud-Based Storage:** Providing cross-device synchronization was deemed unnecessary at this stage, given the application's primary focus on delivering a personalized news experience on individual devices. | ||
|
||
## Product scope |
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 fill these in :)
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 add in more diagrams for a clearer explanation :)
|
||
#### Alternatives Considered | ||
- **Cloud-Based Storage:** Providing cross-device synchronization was deemed unnecessary at this stage, given the application's primary focus on delivering a personalized news experience on individual devices. | ||
|
||
## Product scope | ||
### Target user profile | ||
|
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.
add in more user stories !
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 flow of control from UI to DailyNewsCommand and back to UI is not very clear. You could show explicit method calls from the UI to DailyNewsCommand and any data or control flow that returns to the UI.
docs/DeveloperGuide.md
Outdated
|
||
Below is a snippit of the parser function that handles both of the operations above: | ||
```java | ||
private static void saveDailyArticlesParser() { |
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.
Good for given code, may consider use pseudo-code to increase readibility
docs/DeveloperGuide.md
Outdated
- `FilterNewsCommand#info()` — displays the importance, reliability and bias measure of the article to the user. | ||
- `FilterNewsCommand#back()` — Exits the filter topic feature. | ||
|
||
Given Below is an example usage scenario and how the filter and topic mechanism behaves at each step. |
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.
Good to have sample output here!
docs/DeveloperGuide.md
Outdated
The `Topic` function is complemented by the `Filter` Function which displays the list of articles related to the | ||
specified topic. | ||
|
||
#### Filter Function |
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.
Nice to provide Filter function here!
} | ||
``` | ||
|
||
#### Design Considerations |
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 think this part is good to write the consideration!
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. Consider using "opt" if there is only one path and also make use of algorithm to increase the readability.
docs/DeveloperGuide.md
Outdated
.filter(article -> article.endsWith(";" + topic)) | ||
.collect(Collectors.toList()); | ||
|
||
if (!articlesForTopic.isEmpty()) { |
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.
Consider using pseudo-code or algorithm to increase readability
Alternative 1 (current choice): check for topicIndex in handleCommand | ||
- Pros: easy to implement | ||
- Con: duplicate checking of topicIndex for article commands | ||
|
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.
Its good that you provided some alternatives with their pros and cons
docs/DeveloperGuide.md
Outdated
is used to retrieve the source of a news article. | ||
The function takes in a string and a list of | ||
`NewsArticle` objects. The string is split into an | ||
array and the second element (index 1) is parsed as |
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.
Isn't it just index. The usage of "index 1" is not clear here.
docs/DeveloperGuide.md
Outdated
topics of the news articles. | ||
|
||
The following sequence diagram shows how the topic operation works. | ||
<img src="UML Diagrams/topicFunctionSequence.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.
Update User Guide
please accept my pr; added Ui stuff plus updated documentation
Final DG changes
…Branch * 'master' of https://github.com/BenjoBurger/tp: Final DG changes (Adjust line length and import Resolve conflicts Update DG, Add extract to DG, fix test case Update DG design sections, add extract to DG, Fix test cases
Update PPP
Update PPP links
quote fix
…benjoBranch * 'benjoBranch' of https://github.com/BenjoBurger/tp: quote fix quote and daily fix at hiteshri's request Update PPP links remove duplicate extract Update PPP
Update to UG and DG
Update PPP
edit UI for daily function
News on the Go is a desktop command line app for getting your news on the go, i.e. quickly, conveniently, accurately, unbiased, and relevant to you. If you type fast, News on the Go will get your daily news to you faster than browsing Google.