Barely legible text for diagrams

[MarcusTXK]

Expected:

• Diagrams should aid the developer in understanding the product easily.
• This happens in multiple diagrams, which is perhaps a sign that these are too complicated and should be split.

Actual:

• Text in the diagram is very small, making it very hard to read. I have to zoom in alot to read, and if I do so, I am unable to view the whole diagram easily, making it very hard to follow it.

More examples:

[nus-pe-bot]

Team's Response

1) This is purely cosmetic

2) WRT the sequence diagram, while in most cases we would agree, for these two the process is already explained in detail before the diagram. All the parts in the diagram are 'essential details' as it is intended to be a low-level illustration of the way the command works; splitting the diagram into 2 will obstruct the meaning even more. (As you can see, it is a single command)

Items for the Tester to Verify

:question: Issue severity

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

• [x] I disagree

Reason for disagreement: ### Reasons for disagreeing with team's response

• I will not dispute the team's claim of all parts being 'essential details'. However, the diagrams can still be split up using reference frames as seen below. The argument that is a single command and hence cannot be split up does not make sense. This is the reason why reference frames were created, to help break complicated sequence diagrams into multiple parts or simply to omit details you are not interested in showing. In this case, not splitting up the diagram is in fact hindering the user from easily understanding the diagram due to the high complexity and tiny font.

Rationale for severity

• This is no longer merely a cosmetic issue when you cannot even read the words. This brings inconvenience to the users and affects the usage of the DG, as they have to zoom in significantly to even read what is even stated (slightly blurry words due to the large zoom in required), and if they do so, they cannot even view the entire diagram, having to scroll horizontally and vertically to follow the diagram's arrows.

Example of me trying to read the sequence diagram after zooming in till the text in the sequence diagram roughly matches the original font size of the rest of the DG text:

---