search

brendanlsz / pe

0 stars 0 forks source link

Some sequence diagrams appear drastically different from others #14

Open brendanlsz opened 2 years ago

brendanlsz commented 2 years ago

Below are two sequence diagrams taken from the Developer Guide. The diagrams are not consistent with each other in terms of format and color.

image.png

image.png

nus-se-bot commented 2 years ago

Team's Response

Does not hinder reader from understanding developer guide.

Cosmetic issues are VeryLow.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: As a reader, I would have been confused seeing this variation in the sequence diagrams. Since only one sequence diagram was color-coded, I would have thought, do the colors mean anything in the first sequence diagram? when there is no meaning behind the colors.

This undermines your professionalism and also undermines the credibility of the documentation.

:question: Issue severity

Team chose [severity.VeryLow] Originally [severity.Low]

Reason for disagreement: [replace this with your explanation]