Happy Apple Bug Friday: Typos and unclear styling in 'Designing Network-Friendly Applications'

Apple just released a nice little article on making applications more network-friendly.

It's a great article. It's short, concise, and it gets the point across, since it finally concerns itself with actual use cases of technology and walks one through the process. It ends a little abruptly (a list of other available types in the manifest entries would have been nice, and a short example of a minimal, but complete manifest plist to make the structure clearer), but it's a good start.

The problem: Lots of typos. They'll want to have a human run over this again to fix those, they're beyond the typical spell checker. It's stuff like "Also knows as forcing the preference setting" (instead of "knowN").

Also, in a few places it reads like it was typed by a voice recognising dictation system, e.g. "Use library application support for storing any files that make sense to store for the system", which should probably be "/Library/Application Support" or "~/Library/Application Support" or "the Application Support folder in the appropriate Library folder".

Filed as Bug ID 4321673.

Reader Comments: (RSS Feed)

Duncan Wilcox writes: They might have overlooked text, but they certainly put some thought into samples, check out the user names in the first screenshot: Arthur Dent, Ford Prefect, Humma Kavula, Marvin Android, Tricia McMillan, Zaphod Beeblebrox :-)

Uli Kusterer replies: ★ Heh! You know, I actually completely missed that! :-D

Or E-Mail Uli privately.