New Contributors - Contribution Guide/Discussion

[addyosmani]

For those interested in contributing to the upcoming jQuery Learning site, welcome!

As you might guess, this is a project focused on creating an authoritative educational resource for those wishing to learn how to use jQuery (ranging from beginners to more advanced users). It's being driven by the jQuery project and we hope that you'll consider contributing some of your time to helping us improve the content we have at the moment and appreciate any of your efforts.

Some history:

The site initially started off with Rebecca Murphey's jQuery Fundamentals book (which she gave us permission to use), which we split up into individual sections, iterated upon and improved over the past few months. Early on we wanted to ensure we covered as many relevant topics as possible and reached out to writers in the community to give us permission to use some of their blog posts, a few of which were integrated into our content as well.

The resulting current state of the site can be viewed here:

http://stage.learn.jquery.com/

Now, there are a few problems with the content we've got at the moment.

• While much of it made sense in the context of jQF, there are areas that are seriously lacking material and need to be fleshed out further. I've been taking charge lately of reviewing these sections and identifying what needs to be changed. Ajax is an example of one such section: Content-review: $.ajax() #38 as are the jQuery basics Content-review: jQuery Basics #40 (there are many others in need of improvement too)
• Although we have permission to use articles from a number of sources, I would say that the book in it's current form isn't an accurate representation of the latest version of jQuery. We need a lot more work covering everything from Deferreds through to attributes/props, on/off and a lot more. The release changelogs on http://blog.jquery.com might help here for anyone wondering what changed.
• Again, although we have permission to use other people's articles, it doesn't mean that a good article is up to date or reflects the latest best practices. I also think we may need to spend more time fleshing out basics sections like the JavaScript 101

So, how can you help?

We need developers who are either experienced with technical writing or are willing to try their hand at it to take a look at the content we have at the moment and help improve it. If you see a section you feel could be addressed better and would like to get involved, why not open up a new issue, fork the project and keep us updated on your progress improving a section? :) You'll be helping a potentially large number of developers get to grips with the library and it's an excellent way to sharpen your existing skills.

Some notes:

• If you would like to contribute, forks and pull requests are the best way to do this
• Should you find an article out there at the moment you feel would be worth incorporating in your pull request, please ensure that you clearly state a) the URL the article came from, b) the original author. This is needed so that we can request permission to use it directly
• All pull requests will be technically reviewed for accuracy by either me or another member of the team. We may ask that you tweak a submission if there are errors found.
• We currently have an extensive amount of work being done on the site infrastructure (i.e how the markdown files are being converted, imported, handled etc) so please only change the markdown files themselves and nothing else

How is this different to the jQuery docs?:

Most of this is best addressed in the following thread: #39

Anything else you need to know

We've covered the major points above but some developers have asked us about timelines. At the moment we probably have a few months to get everything in the project tidied up, but there's a lot of work we need to get through during that time. If you would like to tweak your skills and think you could contribute improvements to the project, please feel free to send us through pull requests.

We've happy to take any questions in this thread (or even comments if you'd like to let us know you want to work on something).

This page will be getting moved to the wiki shortly, but thanks to anyone willing to get involved. We appreciate it!

[JosephSilber]

For reference: what sections are considered well written and/or ready for prime time?

[addyosmani]

@JosephSilber We're going to come up with a revised list of areas we would like better covered over the next week or two. If you're still interested in contributing feel free to let us know (or keep an eye out for updates) and we should have some soon :)

[addyosmani]

@ajpiano I'm closing this as it would be better suited in the wiki. If you could reference https://github.com/jquery/learn.jquery.com/wiki/Contributing when you're updating the README that would be awes <3