3 ms·
Speaking as a technical writer, if that many vendors misinterpreted the documentation then it was the fault of the documentation.
by Sgt_Apone 8y ago
Speaking as a technical writer, if that many vendors misinterpreted the documentation then it was the fault of the documentation.
- Someone 8y agoIt also could be innate complexity of the thing being documented. Looking at https://software.intel.com/en-us/articles/intel-sdm https://software.intel.com/en-us/articles/intel-sdm, the combined PDF has 4.844 pages.
- Sgt_Apone 8y agoI 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.