Hacker News new | past | comments | ask | show | jobs | submit login

I think we are saying the same thing; it’s a cheeky remark that to read Apple’s documentation is in it of itself, a learned skill, essential to being productive in Swift.

I read the comment as Woz saying documentation isn’t for the faint of heart ... true

(Mind you, I love Apple’s docs now, and honestly prefer it compared to Stripe-y and Twilio-y documentation... to me S&T docs are a style that tries to smooth over the cluttered calls and returns. Are they APIs that makes sense to accomplish x style or job succinctly, or do I have to read the 8 million other things I don’t care about to do the one thing I need to do?)




Ah, ok. No, we weren't saying the same thing, but I now understand what you meant, and I also happen to agree. Current Apple documentation sucks. I think you may be exhibiting some kind of Stockholm syndrome :).


You're doing it wrong. The actual documentation is all in the WWDC videos... just better hope it covers the section you're concerned about!




Consider applying for YC's Spring batch! Applications are open till Feb 11.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: