Skip to content

Commit 11bd0e7

Browse files
committed
Add "About This Site" page explaining site mission, history, and current beta status
1 parent 0d2f7b6 commit 11bd0e7

File tree

1 file changed

+69
-0
lines changed

1 file changed

+69
-0
lines changed

page/about.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: About This Site
3+
customFields:
4+
-
5+
key: "is_chapter"
6+
value: 0
7+
---
8+
9+
Learning how and when to use jQuery is a different process for each and every
10+
web developer, depending largely on experience with the primary tools for
11+
front-end development (HTML, CSS, and JavaScript) and knowledge of general
12+
programming principles. Over the years developers of all stripes have come to
13+
rely on our [API documentation](http://api.jquery.com) for help figuring out
14+
how to do exactly what they need to do.
15+
16+
However, API documentation alone cannot serve as a guide to solving problems
17+
and fostering a true understanding of web development. Over the years, an
18+
ecosystem of blog posts, books, support forums and channels has grown to help
19+
cover the **hows** and **whys** of developing with jQuery, as well as explaining
20+
best practices, techniques, and workarounds for common problems. This type of
21+
documentation has been invaluable resource for millions of people, but the
22+
experience of navigating these waters can be frustrating as often as it is
23+
fulfilling, as developers struggle to identify trustworthy resources, determine
24+
whether what they're reading is actually up to date, and figure out those
25+
magical search keywords that are _just right_!
26+
27+
This site represents the jQuery Foundation's ongoing effort to consolidate and
28+
curate this information in order to provide this crucial "narrative
29+
documentation" to our community and serve the following goals:
30+
31+
1. Provide our **users** with a digestible reference on all aspects of using jQuery, from the basics of getting started and performing common tasks to more advanced topics like approaches to structuring code and where jQuery fits into modern web application development.
32+
2. Provide our **contributors** a central, open place to collaborate and provide a dependable, highly sharable resource that will improve our users' support experiences
33+
3. Foster an environment by which users are encouraged to become contributors and build the skills to help them work on jQuery -- or any other open source project!
34+
35+
In order to achieve these goals, all of [this site's content is maintained
36+
publicly on GitHub](http://github.com/jquery/learn.jquery.com) and is licensed
37+
under the [Creative Commons Attribution-Share Alike 3.0 United States
38+
license](http://creativecommons.org/licenses/by-sa/3.0/us/). To learn more
39+
about how the site works, take a look at our [contributing guide](/contributing).
40+
41+
## History
42+
43+
The jQuery Learning site has its roots in two primary places.
44+
45+
The first is Rebecca Murphey's [jQuery Fundamentals](http://jqfundamentals.com/legacy),
46+
a free, open source book on jQuery basics she originally released in 2010.
47+
Seeking a better home where the information could be both maintained going
48+
forward, and consumed in a more piecemeal fashion, Rebecca donated the content
49+
to the jQuery Foundation to form the basis of what was then an abstract idea
50+
for some sort of "learning center."
51+
52+
The second is [docs.jquery.com](http://docs.jquery.com), that erstwhile
53+
chestnut still living out its final days before it will be shut down in early
54+
2013. Since we've moved the API documentation for jQuery Core off that domain,
55+
we needed a place that could serve a similar need -- documentation (that anyone
56+
can contribute to) that gets into the "how-to" and FAQs -- without clumsy
57+
barriers to entry like finding the right person to set you up with a special
58+
wiki account and forcing all authoring into a `textarea`.
59+
60+
<h2><a name="beta">About the Beta</a></h2>
61+
62+
Though this resource will never truly be "done," the current version of this
63+
site should still be considered something of a preview. We still have a number
64+
of improvements we want to make to both the content and the user experience
65+
before we're ready to call it a "final release." At the same time, however,
66+
it's important for us to open the doors now so we can begin providing better
67+
docs to people who need the right away and spread the word about this effort.
68+
If you're interested in helping us reach the finish line, we invite you to
69+
please read more about how [you can get involved with contributing](/contributing)!

0 commit comments

Comments
 (0)