Pete Schaffner
Mitchell HashimotoWhen you're developing against Apple technologies and web search takes you to a page with the left header you know you're about to find some good answers. If you see the right header, you know you're about to learn jack shit.
Darryl Ramm@mitchellh Ha. Yes absolutely. The older the better.
Andy Lee@mitchellh I don't hate all the "modern" docs, but for sure there's tons of treasure in the /archive docs.
Chris Wu 🪐@mitchellh I filed Feedback saying that I desperately need code samples to help me understand a concept. I have noticed that for some entries they have gone back and populated some.
sometimes ian@mitchellh Apple's old documentation: *has multiple paragraphs with examples on how and why to use function `openFoo`*
Apple's new documentation: "openFoo will open a foo"
Jim Luther@mitchellh Inside Macintosh is how Apple Documentation should be written.
Jonathan HendryI really liked NeXT's developer documentation for AppKit.
@jonhendry @mitchellh NeXT hired Caroline Rose for their documentation. Caroline Rose was the lead writer of the original Inside Macintosh. 😀
@jonhendry @mitchellh she may not have written that NeXT documentation but she probably influenced them doing docs the right way.
Apple needs to give her all the monies and hire her.
Everyone attending WWDC-related events should wear shirts that say "Hire Caroline Rose"
This explains a lot.
@jonhendry @mitchellh Scott Knaster has a great Steve Jobs story related to Caroline Rose. There’s video of Scott telling that story on YouTube IIRC. It might be in this https://www.youtube.com/live/r9FHpKgxo6w?feature=shared
Solo Performance Theater : Scott Knaster, "Adjacent to Greatness"
She also did an oral history with computerhistory.org
https://archive.computerhistory.org/resources/access/text/2024/03/102808938-05-01-acc.pdf
Is it the "are you the best ... in the world” question?
She tells her version in her oral history.
@jimluther @jonhendry This is all amazing history thanks for sharing.