Open howtoosee opened 4 years ago
This is a minor format mistake in the user guide. The usage of date being optional is explained in the point below the format in the very next line, which can be seen in the screenshot provided. The reason why we have lowered the severity of the bug is because we believe it does not hinder the reader and is a cosmetic bug.
Team chose [severity.VeryLow
]
Originally [severity.Medium
]
Reason for disagreement: I believe that this is still considered as a documentation error. While it is true that it is explained in the next line that Date is optional, it was also explained at the start of the UG that only parameters in []
are optional. The fact that two lines of contradicting information being so close to each other still may result in misunderstanding and confusion.
Though I agree that the serverity can be lowered, the discrepency is still misleading, hence, the severity should be kept at medium or at least a low.
Discrepency in format for
DATE
which is not put in [ ] but optional.