Hacker News Board Hacker News, browsed like a classic message board
Live data from Hacker News

Apple Developer Documentation Is Missing

v4.chriskrycho.com

Post reply on HN
Print view View original

371–380 of 400 posts

Re: Apple Developer Documentation Is Missing

#371

Post by Fnoord »

jariel wrote: post #355
dillonmckay wrote: post #344

Earlier quoted context omitted.

Wasn’t there also an issue of allowing foreign governments to MitM their service? All the data was routed through Canada, right?

Yes, but that's an entirely different and complicated can of worms. Due to its 'highly secure nature' it was sought after by individuals within regimes that had known surveillance and BB was way ahead of FB/Google in terms of attention by national powers around the world and having to 'deal with them' - at very least because it was actually used by entities in the first place! One of the drawbacks of Barack Obama usi…

> I can say however that Venezuela specifically was never going to get any help from us

Why specifically not Venezuela?

Re: Apple Developer Documentation Is Missing

#372

Post by saagarjha »

edw wrote: post #154
chriskrycho wrote: post #143

Earlier quoted context omitted.

Edit: this first paragraph is wrong, see child comment. Leaving for posterity. The second paragraph I stand by. SwiftUI is not in beta. It may be beta-quality, but they shipped it and encouraged devs to use it . Yes, it has undergone significant breaking changes since WWDC (and that's to be expected), but it's not described as beta anywhere in their docs about it. (See https://developer.apple.com/xcode/swiftui/ and h…

You are wrong. Go into the documentation viewer in Xcode and click on any page of SwiftUI documentation. SDK support is listed thusly: iOS 13.0+ Beta macOS 10.15+ Beta tvOS 13.0+ Beta watchOS 6.0+ Beta Mac Catalyst 13.0+ Beta [Edit: indentation]

That's almost certainly just documentation that has not been updated to take into account that all of those SDKs have been released publicly. SwiftUI is not in beta anymore.

Re: Apple Developer Documentation Is Missing

#373

Post by saagarjha »

pmjordan wrote: post #65
non-entity wrote: post #2

I haven't done a lot of work in Apple ecosystems, but what I have seen from their docs are admittedly pretty bad. Recently out of curiosity, I tried to figure out how macOS drivers are written and left more confused than I was before. Microsoft iirc, used to have their docs terribly organized (it was difficult for me to find what I wanted without a Google search) but they seem to have improved that nowadays

Driver development docs on macOS largely haven't been updated in 10+ years. I started doing macOS kernel stuff when Snow Leopard was the latest release, and the only documentation I can think of since then has been sample code for Audio Server Plugins (for writing new-style audio drivers) and headerdocs explaining the transition from IOUSB* to IOUSBHost* APIs. Any additional information has been buried in a bunch of…

I hope Apple credited you the DTS incidents back for something like that!

Re: Apple Developer Documentation Is Missing

#374

Post by saagarjha »

TheKarateKid wrote: post #334

I’m surprised no one has complained about the lack of documentation for Safari, especially on iOS where special behavior is done for mobile. The best I could find from Apple was several years old, and clearly not up to date as the behavior no longer functioned as documented.

There is this: https://developer.apple.com/library/archive/documentation/Ap.... Not sure if this has what you'd need.

Re: Apple Developer Documentation Is Missing

#375

Post by saagarjha »

lasermike026 wrote: post #202

If there is a problem with Apple documentation issue a bug report. I'm not from apple but I worked in their ecosystem for some time. When you experience real problems your manager or CTO might have to get in touch with a managing director. If you go to WWDC make sure you complain directly to the guys wearing the checkered shirts. They are the ones in change. The cool thing about WWDC is that you can communicate direc…

> When you experience real problems your manager or CTO might have to get in touch with a managing director.

If you can…

> If you go to WWDC

Again, if you can…

Re: Apple Developer Documentation Is Missing

#376

Post by saagarjha »

perfectstorm wrote: post #184

So much this. The other day i was trying to look up documentation for Swift’s KVO and i couldn’t find one. I know there’s a KVO API that accepts a closure but i just couldn’t find where it is. smh. Apple used to link sample code with pretty much all the big APIs but they no longer do that. If you want to see how an API is used or see the best practices you’re better off checking stackoverflow.

You're looking for NSObject.observe(_:options:changeHandler:), which doesn't seem to have a dedicated documentation page that I can find but it's mentioned here: https://developer.apple.com/documentation/swift/cocoa_design...

Re: Apple Developer Documentation Is Missing

#377

Post by saagarjha »

russellbeattie wrote: post #338
saagarjha wrote: post #335

Earlier quoted context omitted.

Nobody seems to use JXA, unlike some of the technologies that are heavily used but just as undocumented :(

I don't disagree, but you might be confusing the chicken and egg. Maybe if Apple actually documented JXA... (it's actually quite useful).

I know it is, but I have little hope that it ever will. Everything I've heard points towards the OSA team not doing so hot these days.

Re: Apple Developer Documentation Is Missing

#378

Post by kalleboo »

strictfp wrote: post #222

Apple payments APIs are the worst APIs I've ever worked with. They're inconsistent, badly documented, have unannounced breaking changes and contain so many gotchas it isn't funny. For example, some of the most relevant data is attached to the response but isn't officially supported and may or may not be correct. It's not exactly fun to code up payment integrations, and so I was kind of hoping to get it over and done…

And what's worse is the "sandbox" for testing behaves completely different from the real store, and has random undocumented downtime and bugs that you only find out about from other people reporting it on the developer forums. And creating, logging in to, and keeping sandbox accounts from contaminating your real devices is also a PITA.

Re: Apple Developer Documentation Is Missing

#379

Post by valleyer »

kalleboo wrote: post #369
Vomzor wrote: post #347

Earlier quoted context omitted.

A better example would be: - Apple: https://developer.apple.com/documentation/coreimage/cicolorc... - Microsoft: https://docs.microsoft.com/en-us/dotnet/api/coreimage.cicolo...

Oh god that's both hilarious and sad at the same time. Maybe Apple should contract Microsoft to write their own documentation for them?

Sadly, Apple actually does have good documentation for Core Image. It just never made it into their new system and is instead languishing in the "archive":

https://developer.apple.com/library/archive/documentation/Gr...

Apple deployed a new documentation system, and no one stopped to make sure all the "old" stuff got translated through.

Re: Apple Developer Documentation Is Missing

#380

Post by jariel »

Fnoord wrote: post #371
jariel wrote: post #355

Earlier quoted context omitted.

Yes, but that's an entirely different and complicated can of worms. Due to its 'highly secure nature' it was sought after by individuals within regimes that had known surveillance and BB was way ahead of FB/Google in terms of attention by national powers around the world and having to 'deal with them' - at very least because it was actually used by entities in the first place! One of the drawbacks of Barack Obama usi…

> I can say however that Venezuela specifically was never going to get any help from us Why specifically not Venezuela?

The Chavez regime is corrupt and totalitarian (and adversarial to the West, aligned with Cuba/Russia) without the geopolitical leverage to get away with such things, unlike like Saudi Arabia ... as an example of a country that does questionable things but still gets access to things like fancy weapons systems.

I wonder to this day how much Google and FB hands over to the Saudis, Russians etc..

Post reply on HN