Re:Apple's apps bypass firewalls like LittleSnitch and LuLu ...
by dkdbejwi383 on Tuesday October 20, 2020 @01:27PM
(#24840071)
> Apple's documentation has long been really dreadful
Developer docs for most of their libraries are usually just the method name in a large font and the parameter types and that's it.
Re:Apple's apps bypass firewalls like LittleSnitch and LuLu ...
by saagarjha on Wednesday October 21, 2020 @03:19AM
(#24845500)
Online documentation. For some reason the qualification is necessary because their header files have a bunch of information that whatever script or tool that generates the webpages doesn’t catch.
Re:Apple's apps bypass firewalls like LittleSnitch and LuLu ...
by TheRealDunkirk on Tuesday October 20, 2020 @02:46PM
(#24840950)
> Apple's documentation has long been really dreadful, mostly nonexistent and where it does exist, usually incomplete and even wrong.
Anyone want to tell him about Microsoft's Azure or .NET documentation?...
It's the same all over.
Re:Apple's apps bypass firewalls like LittleSnitch and LuLu ...
by userbinator on Tuesday October 20, 2020 @03:37PM
(#24841526)
MS docs were great, but after they took down MSDN and let the "community" maintain them on Github, it's been going downhill.
I imagine it is, given the bureaucracy of a big company. Apple's documentation has long been really dreadful, mostly nonexistent and where it does exist, usually incomplete and even wrong. I've assumed it was because the code itself is developed by isolated groups while the documentation presumably has to touch all sorts of people (publishing, translation, language checks, ...) in a kind of Conway's law.
However, hard or not, writing comprehensive documentation is quite doable. I have never been a fan of the Windows programming model but I have long admired not just MS's documentation but the amount of effort and commitment they obviously put in.
Apple cares about some things but in this regard it appears they simply don't give a shit.