Slashdot Mirror
Apple Launches Reference Library
andy55 writes "If you thought Apple's online dev resources were already the best out there, they just got better. Apple has announced the launch of their new ADC Reference Library. Named features are: powerful search options, added navigation, 'Getting Started; docs on key technologies, and a more consistent organization. Impressively, the first search I ran in their search engine on a painful Mach-O dev issue I've been fighting for the last week turned up the key obscure tech info I needed!"
Meanwhile, skrysakj writes "Apple has launched a new Reference Library. I always thought their help/references for Developers was spotty (either non-existent or dead on) so this should be a welcome change."
However, in reference to the "spotty references" on developing... there's plenty of reference material for those who look... nice heavy folder full of documentation in the developer tools installation.
Even though I have no prior reason for distrusting Apple, I get the feeling that eventually this information will be accessible to developers paying a premium rather than those of us who signed up for the free account.
/Developer/Documentation that comes with OSX? 6 years ago I used to sit and while away the hours reading man pages and HOWTOs in Linux, and since I bought a PowerBook I find I'm doing the same kind of thing with their docs which I have locally installed. The ADC (that's Apple Developer Connection, not the monitor connector ;) looks awesome, but a local, offline copy would be even better.
Anyone know if the ADC is going to replace the current
I guess I could always buy a printer...
The newly release Reference Library is very well organized and makes finding things much easier. Good job, Apple! It's been a long time coming!
There's still a problem, though. Much of the "state of the art" documentation is actually happening on the Mac OS X and Cocoa mailing lists. It's good to have reference materials, but if you're looking for information on the latest & greatest addition to the OS, go search the archives.
You'll find that you can get answers directly from the developers before the reference materials are formalized and made public. As an example, in the months following last year's WWDC, there was a ton of information on the lists about the new Cocoa Bindings. As a developer who wants to stay on the leading edge of Mac OS X product development, this is invaluable.
Also, the guy that is running the mailing list archive, is looking for donations. If you are a developer who uses these archives, PLEASE DONATE.
-ch
I don't know shit about programming, but I'm learning. And having a bash shell, with actually useful commands, is really helpful to that goal. So many people don't understand the appeal of a command line, or think that you have to pick a nice GUI or a nice CLI, but that's bullshit. Someone actually asked why I would care about the GUI if I spend so much time with the command line. It seems obvious to me--I can carry on everyday operations with apps familiar to me, but can craft more and more complex helper apps/scripts in my free time. Much simpler than rebooting into Linux when I feel like experimenting, then getting frustrated that I can't burn a CD because the procedure is too complex and having to reboot into a more idiot-proof OS. I welcome any enhancement that makes development easier for the ignorant (like me), and avoids rebooting.
Oh, and I don't want to hear anyone try to compare Windows' cmd.exe with a bash shell. I do use the Windows command line, but it's a total cripple compared to any UNIX shell. Sure there's Cygwin and Mingwin (or something like that), but they aren't very integrated.
Si la vida me da palo, yo la voy a soportar Si la vida me da palo, yo la voy a espabilar
Some of the things I miss from ADC is that documentation updates that seem to be on a regular basis are not downloadable. I don't have access to the net all the time I develop so it would be nice to have it completely offline. As well a search function would be nice. I have it aliased in my apache so a simple php search would be convenient.
It's great because it looks like the Microsoft Developer Network?
Someone toss me a flight bag quick.
Don't want to tout someone's product, but seriously: if you're a pro here, you can't make it fast or far without Andy Lee's AppKiDo. It's easy to Google to, and it's free.
What Andy does is parse the actual documentation you already have on disk, but he does a much better job of it than Apple. Searches are better, faster, more flexible, and so are the renderings.
It's one of the truly indispensable programs out there.
...this is a another sad case of Apple regressing to the mean.
From 1984 through, say, 1998, Apple documentation was some of the best documentation I've ever used. (And I've used the VAX/VMS documentation that came in thirty-or-so China-red binders). Apple documentation accurate, well-written, well-organized, thorough, complete, and written in a down-to-earth developer-to-developer tone of voice.
Meanwhile, my colleagues developing for Windows were struggling with DDK components that were "documented" only with sample code, getting hints and tips from magazine articles, or reading "official" MS material that mixed an enormous amount of propaganda with the technical information.
Unfortunately, one of the things that appears to have come in with the NeXT subculture is a more casual attitude toward documentation. Perhaps they were too much in a hurry to release OS X (did I actually say perhaps?) Perhaps it's a not-so-benign influence of open-source development. I still find all too often that the header files are as good or better documentation than the documents.
OS X documentation is much, much better than it was, say, a year-and-a-half ago, so hopefully this is being addressed. But it really is a pity to journey from superb documentation to inadequate documentation, then climb slowly up to sorta-OK documentation.
The release of the hardbound Inside Mac volumes 1-3 had a tremendous impact within a certain now-defunct Fortune 500 minicomputer company. One director was running around slamming it down on peoples' desks and saying "Look at this! What does it say about Apple? They expect their software to be around forever!"
"How to Do Nothing," kids activities, back in print!