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.
|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 :-)