News for hackers. Stuff that matters.
Re:On Apple's Piss-Poor Documentation by psahgal on Tuesday November 10, 2020 @11:41AM (#25047911)
Even 5 years ago, I felt that Apple's documentation was way worse than Android's.

I wonder if there is a good way to measure documentation quality...I suspect such measures will require techniques borrowed from user experience research.

Re:On Apple's Piss-Poor Documentation by dwiash on Wednesday November 11, 2020 @12:20AM (#25055709)
Yea, i think that's correct. documentation is just another product, no different than other software. so basically you can start asking with very common user reasearch questions such as: * who would use our documentation? * what would our user need the most from our documentation?
Re:On Apple's Piss-Poor Documentation by hutzlibu on Tuesday November 10, 2020 @02:07PM (#25050041)
"I wonder if there is a good way to measure documentation quality"

I would start with a checklist:

- is it complete and consistent

- is there a description to every important piece

- working examples

... and if this is complete, you can measure all you want, but I would start with the basics.