By Casey Liss

Casey Liss · 10 Nov 2020

Casey Liss did not write this page.

Every claim below was made in this piece, quoted word for word and numbered in the order the piece makes them, so you can read it there rather than take our word for it. The sentence above each quote is our reading of the claim, not their wording. Each quote was checked against a stored copy of the page at build time; where the two differ, the quote is the fact.

Our reading
Apple's documentation has been poor for years and has worsened over time.

Their wordsApple's documentation has, for years, been pretty bad. Over the last couple years, it has gone from bad → awful → despicable → embarrassing.
Our reading
Apple often fails to include documentation for new APIs when old ones are deprecated.

Their wordsAs my friend Adam Swinden pointed out to me on Twitter, as old APIs get deprecated, often times Apple can't be bothered to include documentation for the new ones.

Keep reading

The other pieces are the ones whose claims are worded most like this one's. That measures language, not agreement: they may argue the opposite.