django-selectable / docs / contribute.rst

Contributing

There are plenty of ways to contribute to this project. If you think you've found a bug please submit an issue. If there is a feature you'd like to see then please open an ticket proposal for it. If you've come up with some helpful examples then you can add to our example project.

Getting the Source

The source code is hosted on Bitbucket. You can download the full source by cloning the hg repo:

hg clone https://bitbucket.org/mlavin/django-selectable

Feel free to fork the project and make your own changes. If you think that it would be helpful for other then please submit a pull request to have it merged in.

Submit an Issue

The issues are also managed on Bitbucket. If you think you've found a bug it's helpful if you indicate the version of django-selectable you are using the ticket version flag. If you think your bug is javascript related it is also helpful to know the version of jQuery, jQuery UI, and the browser you are using.

Issues are also used to track new features. If you have a feature you would like to see you can submit a proposal ticket. You can also see features which are planned here.

Running the Test Suite

There are a number of tests in place to test the server side code for this project. To run the tests you need Django installed and run:

python selectable/tests/runtests.py

Client side tests are written using QUnit. They can be found in selectable/tests/qunit/.

Building the Documentation

The documentation is built using Sphinx and available on Read the Docs. With Sphinx installed you can build the documentation by running:

make html

inside the docs directory. Documentation fixes and improvements are always welcome.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.