4 ms·
> If I were writing a report on a piece of software for my boss and I found unsanitized inputs to an SQL database, I wouldn't highlight that any more than anyth
by jonahx 5y ago
> If I were writing a report on a piece of software for my boss and I found unsanitized inputs to an SQL database, I wouldn't highlight that any more than anything else I found as he would know that was severe.
I would. And as someone reading the report, even as an expert, I would want and expect the person writing it to organize it by severity, and start by pointing out any urgent items.
What advantage is there to not doing that?
- MattGaiser 5y agoIn my case because I have been told a few times it is patronizing to point out the "obvious." I would prefer (but not expect) the style you discuss as well (as I am not all that comfortable with an assumed base of knowledge for documentation), but I have faced far more negative reaction to that than positive.
- jonahx 5y agoThat sucks. It's hard for me to imagine working with someone so insecure that they would find a convenient, hierarchical organization of report results by severity patronizing.