Time to end the Docset Exchange

[Kapeli]

I've decided it's best if we end the docset exchange between Dash and Zeal, and just give Zeal access to all of Dash's docsets.

My reasoning is that if Zeal becomes very very popular for Windows and Linux, Dash will in turn get a few users as well. Furthermore, more users for Zeal also means that some of those users might generate docsets and hence make it better for everyone. Please note however that Dash's docsets will be available as long as Zeal does not officially support OS X and compete with Dash (which it doesn't at present).

Anyways, I've made a page which lists all of Dash's docsets with download links at http://kapeli.com/docset_links. Feel free to link to it if you want, even from inside Zeal. If appropriate, you might want to also link to http://kapeli.com/docsets somewhere (for instructions on how to generate docsets).

You can also allow Zeal to download those docsets directly. If you do that, please add a "Docsets contributed by Dash" thingy if you can.

I'll do my best to handle the hosting and bandwidth needs for Zeal too.

In the future, you might want to consider supporting Dash feeds, to allow Zeal users to receive docset updates - see http://kapeli.com/docsets#dashdocsetfeed for more details (they're really simple).

[jkozera]

Wow, that's awesome, thanks for being so supportive of Zeal!

I see three items to do related to this:

1. Link to the docsets from zealdocs.org. (I will do it in couple of minutes)
2. Add support for icons from Dash docsets - is it fine for you, @Kapeli, to copy the .tiff files from /Applications/Dash.app/Contents/Resources/ inside Zeal's repo?
3. Allow downloading docsets directly from Zeal, ideally with automatic updates using Dash's feeds.

As for 2 and 3, unfortunately I don't expect to have time for this anytime soon, but I encourage others to submit pull requests.

[Kapeli]

2 - Yes, that's fine.

[mflint]

Forgive me for adding a comment which doesn't contribute any value, but... I just wanted to say thank-you to @Kapeli for opening this issue.

I'm a fully-paid-up Dash user, and will be trying Zeal as soon as I can.

Nice work you guys ;-)

[christoffer]

@Kapeli Wow that is really awesome of you! Thanks!

[Kapeli]

Just a heads up to whoever is watching this issue: I made a edit to my first post to specify that the docsets will be available for as long as Zeal does not officially support OS X and hence will not directly compete with Dash. This is something that I have previously agreed with @jkozera, but I thought I should also mention it publicly.

That said, I must also mention that I am not very strict about this and I really don't think this will ever be a problem.

[brad]

@Kapeli Do you plan to also make stack overflow resources available at https://kapeli.com/docset_links? See #168

[trollixx]

AFAIK, SO is not a regular docset, but rather Dash processes dumps available for download at https://archive.org/details/stackexchange. Adding support for that isn't easy because of the current design issues in Zeal.

Also worth noting, that Zeal does not use https://kapeli.com/docset_links page for over a year now.

[Kapeli]

@trollixx The Stack Overflow docsets are processed and packaged by me. Dash only downloads and uses them.

The online-only docsets should work with Zeal too. Try this one: https://kapeli.com/feeds/zzz/stackoverflow/Akka_Online.tgz

The offline-only docsets don't use the standard format. Instead all their data is inside the docSet.dsidx. Download and unarchive and check out the docSet.dsidx for this docset: https://kapeli.com/feeds/zzz/stackoverflow/Akka_Offline.tgz

[fuzzy76]

I actually left Dash last year when the next version was a paid upgrade, but after stumbling across this issue, I bought it again. :)

[bbkane]

Also buying Dash after using Zeal on Windows. That's really kind of you!

[lock]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for a related request.