nus-se-bot
commented
2 years ago Team's Response
No details provided by team.
The 'Original' Bug
[The team marked this bug as a duplicate of the following bug]
Quick start instructions does not work
Quick start instructions state to open the application via double-clicking.
This does not work.
Instructions should recommend starting the app using the java -jar "app_name.jar" command in terminal/cmd instead of double clicking. Mac users that are unfamiliar with jar files would not know how to start the application if this is not stated correctly in the UG.
[original: nus-cs2103-AY2122S2/pe-interim#69] [original labels: type.DocumentationBug severity.High]
Their Response to the 'Original' Bug
[This is the team's response to the above 'original' bug]
The dev team feels that although the documentation had not included the note on the possible error faced when executing the application by double-clicking it, the severity of the issue isn't as high as the tester originally indicated, a severity of Medium is more apt
This is because the number of MacOS users is relatively low as compared to Windows
Items for the Tester to Verify
:question: Issue duplicate status
Team chose to mark this issue as a duplicate of another issue (as explained in the Team's response above)
- [x] I disagree
Reason for disagreement: The 'Original' bug is about macOS's security warning for jar files due to unidentified developer, my concern is when the security issue is by passed, and the user double-clicked the application, it would start completely normal but have bugs while using the application. Since the user might have no idea such a problem is a well known issue, and due to the completely "normal" looking start up, they might continue to use the application thinking it is working fine.
:question: Issue severity
Team chose [severity.Medium]
Originally [severity.High]
- [x] I disagree
Reason for disagreement: The severity depends on how big of a problem this is, and for that we have to look at the numbers.
I disagree from the dev team's response as looking at just market share between the operating systems can be misleading. Looking at the target users, real estate agents prefer laptops or tablets over traditional pc due to their necessity to be portable working machines.
Looking at the market share of laptops, we can see that more than 20% or one-fifth of the laptop market being not windows. In fact the runner up, Chrome OS is built on top of a Linux kernel and would face the same problem as macOS users.
Looking at the tablet market, window os is no where even close
As such the dev team's response that this isn't a big issue due to the market shares numbers is misleading and in fact, is a sizable amount. And due to the nature that this bug does not have ANY warning at all, I still believe the severity is high as it would make the product completely unusable for users.
Problem: It is a common issue for macOS users in which a jar application would open but not work as expected when double-clicking the application to start, instead of using 'java -jar'. However in the quick start guide, it was explicitly mentioned to double-click to start the application with no notice or caution for macOS users. Due to the large share of macOS users and the high likelihood of error that is hardly detectable due to the application starting as if nothing is wrong (and also follows the successful behaviour as mentioned in the quick start), the severity is high.