search

shawn-nyk / pe

0 stars 0 forks source link

Loop condition in diagram has code-like phrasing. #13

Open shawn-nyk opened 3 years ago

shawn-nyk commented 3 years ago

The loop condition in the following diagram is "for summary in summaries":

image.png

That seems to be a very technical explanation and the reader has to make assumptions as to what it means. Perhaps it may be more appropriate to explain the condition in terms that do not follow coding language so strictly, such as "for number of summaries".

nus-pe-bot commented 3 years ago

Team's Response

Rejected as we think that it is quite clear what the loop condition means. In full english, this would be "for each summary in summaries, execute the loop body", which is not too far off from "for summary in summaries" as a condition for the loop.

Additionally, the target audience for the DG are developers, which are assumed to be coders.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: [replace this with your explanation]