TabrizPlv / pe

0 stars 0 forks source link

Use of misleading terms in UG #10

Open TabrizPlv opened 1 year ago

TabrizPlv commented 1 year ago

Refer to this section of the UG:

image.png

The UG suggests that you add/remove a NAME. However, NAME is defined in the UG as a FIELD. So users of the UG will be led to believe that they are supposed to add any NAME into the inventory. However, I believe that the inventory is supposed to store NAME belonging to items.

soc-pe-bot commented 1 year ago

Team's Response

In the context of the explanation, our team believes that it is quite clear NAME here refers to item names, and there is also a visual example given to illustrate this.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: During the testing phase, it actually took me a long time to figure out that Name was referring to an Item's Name. This is because in the UG, the fact that the Name was supposed to refer to an Item was not made clear. Even in the visual example given, it does not show that the Name should belong to an Item.

For this to be made better, in the screenshot I sent, the "items" should have had some sort of highlighting or notation to make it clearer for users. This is because Name appears in so many different entities.