New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Time to end the Docset Exchange #24

Closed
Kapeli opened this Issue Aug 11, 2013 · 11 comments

Comments

Projects
None yet
8 participants
@Kapeli
Contributor

Kapeli commented Aug 11, 2013

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

This comment has been minimized.

Show comment
Hide comment
@jkozera

jkozera Aug 11, 2013

Member

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.

Member

jkozera commented Aug 11, 2013

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

This comment has been minimized.

Show comment
Hide comment
@Kapeli

Kapeli Aug 11, 2013

Contributor

2 - Yes, that's fine.

Contributor

Kapeli commented Aug 11, 2013

2 - Yes, that's fine.

jkozera added a commit that referenced this issue Aug 11, 2013

@mflint

This comment has been minimized.

Show comment
Hide comment
@mflint

mflint Aug 12, 2013

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 ;-)

mflint commented Aug 12, 2013

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

This comment has been minimized.

Show comment
Hide comment
@christoffer

christoffer Aug 13, 2013

Contributor

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

Contributor

christoffer commented Aug 13, 2013

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

@Kapeli

This comment has been minimized.

Show comment
Hide comment
@Kapeli

Kapeli Aug 14, 2013

Contributor

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.

Contributor

Kapeli commented Aug 14, 2013

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

This comment has been minimized.

Show comment
Hide comment
@brad

brad Apr 13, 2016

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

brad commented Apr 13, 2016

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

@trollixx

This comment has been minimized.

Show comment
Hide comment
@trollixx

trollixx Apr 13, 2016

Member

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.

Member

trollixx commented Apr 13, 2016

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

This comment has been minimized.

Show comment
Hide comment
@Kapeli

Kapeli Apr 14, 2016

Contributor

@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

Contributor

Kapeli commented Apr 14, 2016

@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

This comment has been minimized.

Show comment
Hide comment
@fuzzy76

fuzzy76 Aug 3, 2016

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

fuzzy76 commented Aug 3, 2016

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

This comment has been minimized.

Show comment
Hide comment
@bbkane

bbkane Oct 1, 2016

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

bbkane commented Oct 1, 2016

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

@lock

This comment has been minimized.

Show comment
Hide comment
@lock

lock bot Sep 16, 2018

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.

lock bot commented Sep 16, 2018

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.

@lock lock bot locked and limited conversation to collaborators Sep 16, 2018

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.