Contributing to jQuery Foundation Documentation
For almost as long as jQuery has been around, its documentation has been an integral part of the project, from helping new users get up to speed to offering detailed explanations of features for seasoned developers. Currently, the jQuery Foundation manages API documentation and demos for its projects and provides a growing set of tutorials on its learning site.
If you'd like to help us improve the documentation of any of jQuery's projects, we would love to have your contributions. All of our documentation sites are on GitHub, and their repository names match their website domains. For example, you can find jQuery UI documentation at jqueryui.com and api.jqueryui.com, so their repositories are located at github.com/jquery/jqueryui.com and github.com/jquery/api.jqueryui.com. Before you do anything else, you ought to sign up for a free GitHub account if you don't have one already. If you're comfortable with git and GitHub, you can dive right in by forking a repo, making some changes, and sending a pull request. If not, here are some suggestions for getting involved:
Report an Issue
Perhaps the easiest way to help is to report an issue or problem about the current documentation. We use GitHub's issue tracker for all of our documentation sites. Just head on over to one of the following issue lists to see if your issue has already been reported, and if it hasn't, give us a detailed rundown of the issue:
- jquery.com — View Issues | Report Issue
- api.jquery.com — View Issues | Report Issue
- jqueryui.com — View Issues | Report Issue
- api.jqueryui.com — View Issues | Report Issue
- jquerymobile.com — View Issues | Report Issue
- api.jquerymobile.com — View Issues | Report Issue
- qunitjs.com — View Issues | Report Issue
- api.qunitjs.com — View Issues | Report Issue
- learn.jquery.com — View Issues | Report Issue
Write or Edit Content
If you actually want to make the fixes and improvements, then you'll need to fork the repositories you'd like to work on. Once you've made changes you'd like reviewed for integration, submit a pull request. However, we recommend that you file issues for new "features" and significant changes before actually getting to work. For more information on maintaining your fork and strategies on committing, see the Commits and Pull Requests guide.
All of the API sites use XML for their documentation, while most of the others use a combination of HTML and Markdown. Familiarizing yourself with Markdown is a good idea in general, and it would certainly facilitate your contributions to our sites.
Each of the documentation repositories comes with a build process that uses the
node.js task-based build tool grunt.
It's a good practice to run the
grunt command after changing content because
the command runs a "lint" program that checks for invalid XML and other errors.
For small changes, you probably won't need to see the formatted result in a web
page. For more significant changes, however, it's a good idea to do so before
submitting a pull request in order to avoid mistakes and oversights. All of our
sites use WordPress, and we employ the Grunt build system rather than the
WordPress admin area to update it. For more information about setting up
node.js, Grunt, WordPress, or any other aspect of your local development
environment for working on jQuery sites, see
Contributing to Web Sites.
If you have any questions about getting things set up or if you're not sure about how to address a problem with the documentation, we're here to help.
In addition, the jQuery Content Team holds a public, weekly meeting on Freenode at 1PM Eastern time in the #jquery-meeting channel.
If IRC is not your thing, but you still want to get in touch, please use the site's GitHub repo or send us an e-mail to
content at jquery dot org.