search

florentianayuwono / pe

0 stars 0 forks source link

Confusing d MMMM uuuu hh:mm explanation in DG #27

Open florentianayuwono opened 1 year ago

florentianayuwono commented 1 year ago

image.png

What is EEEE? Maybe if this is intentional can provide links to glossary to explain the weird terms.

nus-pe-bot commented 1 year ago

Team's Response

This is a Java standard date format, this was in the Developer Guide and the program was written in Java. Hence, we expect readers to at least be knowledgeable of Java syntax or formats, otherwise expect the developers to be familiar with Java documentation.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: It is quite contrasting that the team choose to put this in their Glossary:

image.png

"Expecting" developers not to know about popular operating systems like Windows, but expecting them to know about less known date format of EEEE, d MMMM uuuu hh:mm. If it is dd-mm-yyyy hh:mm might still be understandable.

The fact that the tester myself, who is a "Java programmer" that is even taking this module not familiar with this format should tell that the assumption of the team is wrong. In addition nowhere in their Developer Guide that the team states that the programmer should be knowledgeable of Java formats, let alone this specific syntax. Adding to the fact that their glossary only contains 1 word that is inherited from AB3, should tell that the team indeed did not make effort in changing the implementation of AB3 to suit their product needs.