News for hackers. Stuff that matters.
Re:Multiple OS Vendors Release Security Patches After Misint... by Sgt_Apone on Thursday May 10, 2018 @08:52AM (#17038385)
Speaking as a technical writer, if that many vendors misinterpreted the documentation then it was the fault of the documentation.
Re:Multiple OS Vendors Release Security Patches After Misint... by Someone on Thursday May 10, 2018 @12:37PM (#17040464)
It also could be innate complexity of the thing being documented. Looking at https://software.intel.com/en-us/articles/intel-sdm, the combined PDF has 4.844 pages.
Re:Multiple OS Vendors Release Security Patches After Misint... by Sgt_Apone on Thursday May 10, 2018 @02:06PM (#17041451)
I have no doubt that the complexity adds to the difficulty of documenting it. But, I still think the documentation is failing when people across the industry who should be able to parse this complexity are unable to. Complexity just isn't an excuse for broadly misunderstood documentation in my opinion.