yuzhongng / pe

0 stars 0 forks source link

The example given when giving the initial set up of "adding of staff" can be more clear. #13

Open yuzhongng opened 2 years ago

yuzhongng commented 2 years ago

The description of the initial set-up of the "adding of staff" can be more clear. I as the reader assume that the example given was meant for the function "adding of staff".

image.png

soc-se-bot commented 2 years ago

Team's Response

This details of adding staff is provided further down. This example is used as an example for printing staff.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: image.png

It is not obvious that the lines shown in the picture above is meant for the original input of the staff as I do not know what all the numbers and words represent. The statement adds more confusion for the user as it is quite redundant in the explanation of the printing of staff feature as it is confusing and unclear.


:question: Issue severity

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

Reason for disagreement: image.png

I agreed that it should not warrant a medium severity but it also should not be labeled as very low severity. It should be labeled as severity low instead.

It is not obvious that the lines shown in the picture above is meant for the original input of the staff as I do not know what all the numbers and words represent. The statement adds more confusion for the user as it is quite redundant in the explanation of the printing of staff feature as it is confusing and unclear.

The statement that causes confusion as it the explanation is unclear should not be labeled as very low in the severity assignment. It is not a purely cosmetic issue and it affects the usage of the user guide. I as a first-time user and reader, takes a while to understand the usage and the explanation of the feature due to the confusing and unclear statement.