On Nov 8, 2016, at 04:08 , Charles Jenkins <cejw...@gmail.com> wrote: > > Now that Apple’s docs have been reformatted attractively with plenty of > whitespace, it seems crucial requirements info is often missing.
Yes, I agree, both that many useful pieces information are gone or not linked to, and that the web pages take up far too much vertical space. It’s odd, because the documentation team is very responsive and (in the posts they’ve made here over the years) seem very committed to providing the best documentation possible, but the documentation doesn’t seem to be converging on any kind of “best”. It’s just different every year. > *I’m sure someone will be able to reply to this with a link and say “See? It > was right here!” But the word “import” doesn’t appear anywhere on important > pages where it should be such as > https://developer.apple.com/reference/usernotifications > <https://developer.apple.com/reference/usernotifications> or > https://developer.apple.com/reference/usernotifications/unusernotificationcenter > > <https://developer.apple.com/reference/usernotifications/unusernotificationcenter> Perhaps there’s a little bit of cultural shift going on, too. When there were no modules, the Obj-C #import statement was not necessarily predictable, but now you just import (Swift) or @import (Obj-C) the module name, aka the framework name. The first of those links tells you that the framework name is UserNotifications, and the framework name is visible in the black bar at the top of the page in the second link ("UserNotifications > UNUsernotificationCenter”). I’m still not used to this. I still have to think about it when I get an undefined symbol error. <sigh> _______________________________________________ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to arch...@mail-archive.com
