Dash is amazing. I agree that the current interface in Xcode is less than good and the web interface is meh.
Dash, however, is amazing. On Jul 9, 2015, at 12:18 PM, Jack Brindle wrote: > Way back when (Xcode 3) the doc interface was pretty good. Now its really > awful. The web interface is far better. But Dash is even better than that. > Dash 2 (and now Dash 3) gives you searchable interface for not just Xcode > docs but others as well. Dash 3 extends this, adding archives, and as far as > I am concerned, it a much better experience. Dash is definitely recommended. > > Note though that Dash does suffer from the same issue that the Xcode docs > suffers from, since it uses those docs. If there is an error in the docket, > then it will show up both places. The best example is the -hash method in > NSObject. For some unknown reason it was marked as deprecated in the 10.10 > docs. It is correct on-line, and in the 10.11 docs, but… > Weird.. > > Also, take a good look at the Dash content. I believe the Mac version does > contain both sample code and tech notes, and contains support for snippets. > The iOS version does not contain snippet storage as I recall. With Dash 3, > though, there is a cool new feature - mate your iPad to your Mac and it > becomes the display for your docs, giving you back precious screen real > estate. Works quite nicely. > > Definitely worth the $20 (plus additional $10 for the Dash-3 upgrade) I paid. > > - Jack > >> On Jul 9, 2015, at 12:02 AM, Roland King <r...@rols.org> wrote: >> >> >>> On 9 Jul 2015, at 14:52, Graham Cox <graham....@bigpond.com> wrote: >>> >>> >>> Is anyone using Dash for API documentation? Can you recommend it? >>> >>> I received a bundle offer including this today and it seems like a good >>> deal, but wonder if it’s worth using over and above XCode’s standard docs? >>> >>> —Graham >>> >> >> Love it - don’t use anything else. It’s a hotkey away - you can pick docsets >> so I have an OSX set and an iOS set (both of which include XCode’s docs >> too). There’s a snippet editor I’ve not really used as much as I ought to, >> you also get updated downloads of lots of other useful manuals like perl and >> shell etc. It was upgraded recently to Swift-compatible BUT you can turn it >> off and just see the ObjC stuff if you like. >> >> Downside I guess you don’t get searchable tech notes and example code, just >> the API docs. That’s about the only time I go back to Xcode’s doc viewer. >> >> I did get an update the other day which just told me a new version is on the >> way, or just released perhaps. I think I have Dash 2, this is Dash 3 and is >> an extra 10 bucks which I will probably end up paying eventually. How that >> works thru the appstore I’m not entirely sure - I didn’t think you could do >> paid upgrades through the appstore. >> >> Anyway you can try it out for free IIRC - give it a few days and see if you >> like it. x >> _______________________________________________ >> >> 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/jackbrindle%40me.com >> >> This email sent to jackbrin...@me.com > > > _______________________________________________ > > 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/zav%40mac.com > > This email sent to z...@mac.com _______________________________________________ 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
