Skip to content
Dash repo of user contributed docsets
Python CSS Shell Go JavaScript Perl Other
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Sample_Docset Add Standard ML Docset (#1037) Aug 18, 2016
docsets Processed docsets/LifterLMS/versions/3.34.1/LifterLMS.tgz Aug 21, 2019
.gitignore - Updated Pyramid docs with latest revisions Nov 9, 2014
.travis.yml Update .travis.yml Oct 31, 2017
README.md Update README.md Aug 21, 2017

README.md

Dash User Contributed Docsets

Report a bug or request a docset

Open an issue.

Install a docset

You can install these docsets from Dash's Preferences > Downloads > User Contributed.

Improve an existing docset

Navigate to the docset you want to fix in the docsets folder, improve it and submit pull requests.

You do not have to fix the existing generation script if it's too flawed or in a language you're not comfortable with, you can write a new generation script and completely take over the maintenance for that docset if you wish, just make sure you justify your reasons (i.e. how your improved docset is better) when submitting the pull request.

Contribute a new docset

To contribute a docset, follow the steps below. If you get stuck at any point or have any questions, open an issue. I'll help.

  • Generate a docset by following the instructions at http://kapeli.com/docsets
    • Note: you can ignore the instructions regarding docset feeds. You won't need them if you plan to contribute to this repo
  • Make sure your docset fulfils all the required criteria on the Docset Contribution Checklist and as many of the optional ones as possible
  • Check out the Versioning Guidelines to understand how docset versioning works in Dash
  • Fork and clone this repo
  • Set up your directory structure:
    • Copy the Sample_Docset folder into the docsets folder and rename it. Use the same name as your docset, but replace whitespaces with underscores. Note: don't add _Docset at the end of the name, just use the docset name (e.g. ExtJS) and nothing else.
    • Archive your docset using:
    tar --exclude='.DS_Store' -cvzf <docset name>.tgz <docset name>.docset
    • Copy your docset archive
      • Note: don't worry about this repo's size getting huge. As soon as your docset gets distributed to my CDN, it will get removed from the repo automatically. If your docset exceeds GitHub's file limit of 100 MB, open an issue and we'll figure out a different way to submit your docset
    • Include a icon.png and icon@2x.png with sizes 16x16 and 32x32 or simply delete the sample icon if you don't want an icon at all
    • Edit the docset.json file. Make sure to follow the same naming rules as the sample (i.e. your docset name should be the same as the archive name, but replace whitespaces with underscores)
    • Edit the README.md
  • Submit a pull request
You can’t perform that action at this time.