Skip to content

Latest commit

 

History

History
47 lines (22 loc) · 3.12 KB

README.md

File metadata and controls

47 lines (22 loc) · 3.12 KB

The jQuery Learning Site

This site aims to be an authoritative educational resource for those wishing to learn how to use jQuery. From beginners, to more advanced users. It's being driven by the jQuery community.

About

The goal of this site is twofold:

  1. To serve as a central, trustworthy, narrative compendium of information about how to use jQuery and JavaScript.
  2. To remain a timely, vibrant, and community-driven reference with a relatively low barrier to contribution.

Much of the initial content - and spirit - comes from jQuery Fundamentals, an open-source book about jQuery, originally written by Rebecca Murphey and released in 2010. In 2011, Rebecca bequeathed the book unto the jQuery Foundation to serve as the basis for this site. The book was split up into individual sections, whch we iterated on and improved over several 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 integrate some of their blog posts as well.

How This Site Works

This site's core content consists of Markdown files. The template that controls the site's appearance is a child theme of jquery-wp-content, and any issues with the presentation should be directed to that repository.

Site Organization

All of the content lives inside of the subdirectories of the page directory. Each of these subdirectories is considered a chapter, and contains one or more articles, and there is also a top level file that corresponds to each chapter, which contains the chapter's human-readable title and an overview, which will appear on the chapter's landing page.

The order.json file controls the order that chapters and articles appear in the site.

Front Matter

Each of the articles on the site has some JSON "Front Matter" that contains metadata. All articles should include the following:

  • title - The title of the article as it will appear in the site.

"title": "jQuery Event Extensions"

  • level - The approximate level of jQuery experience required to find the article useful. Options: beginner, intermediate, or advanced.

"level": "advanced"

Building and Deploying

To build and deploy your changes for previewing in a jquery-wp-content instance, follow the workflow instructions from our documentation on contributing to jQuery Foundation web sites.

How Can I Help?

We encourage contribution from anyone. For more comprehensive documentation on how to get involved, please read our contributing guide.