You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Depending on your level of experience with some of the workflows common to many
10
-
open source projects, e.g. git/GitHub, the command line, and setting up a
11
-
local development environment, contributing to this site may be a breeze or
12
-
come with a bit of a learning curve. If you fit into the former group, great!
13
-
Jump ahead to learn how to get started.
14
-
15
-
But if you think you're part of the second group, and have had trouble
16
-
participating in open source because of a lack of comfort with the tools,
17
-
**you're still welcome**! Beyond providing a resource for learning jQuery, a
18
-
major goal of this site is to provide an encouraging environment for you to
19
-
develop these skills, while still making a contribution that matters. Many
20
-
people think that the only way to get involved with a programming project like
21
-
jQuery is to solve intricate bugs that require a nuanced understanding of the
22
-
codebase, or to propose enhancements that may or may not be in scope with the
23
-
development team's plans. The fact is that there's way more: improving
24
-
documentation, working on web properties, and supporting other users are
25
-
crucial aspects where more help is always needed. If you're willing to share
26
-
your time and expertise to help other developers, we're willing to [help you
27
-
get up to speed with the tools](#getting-help) you'll need.
9
+
Depending on your level of experience with some of the workflows common to many open source projects, e.g. git/GitHub, the command line, and setting up a local development environment, contributing to this site may be a breeze or come with a bit of a learning curve. If you fit into the former group, great! Jump ahead to learn how to get started.
28
10
11
+
But if you think you're part of the second group, and have had trouble participating in open source because of a lack of comfort with the tools, **you're still welcome**! Beyond providing a resource for learning jQuery, a major goal of this site is to provide an encouraging environment for you to develop these skills, while still making a contribution that matters. Many people think that the only way to get involved with a programming project like jQuery is to solve intricate bugs that require a nuanced understanding of the codebase, or to propose enhancements that may or may not be in scope with the development team's plans. The fact is that there's way more: improving documentation, working on web properties, and supporting other users are crucial aspects where more help is always needed. If you're willing to share your time and expertise to help other developers, we're willing to [help you get up to speed with the tools](#getting-help) you'll need.
29
12
30
13
## Why Contribute?
31
14
32
-
If you've ever looked for help with jQuery -- or with web development in
33
-
general -- you know the hunt can sometimes be challenging. It's can be a
34
-
process of wading through a number of different posts until you find that
35
-
article that's the right combination of trustworthy, timely, and helpful for
36
-
your particular problem. And if you're one of those authors -- thanks! -- then
37
-
you are probably familiar with the frustrating feeling of putting a useful tip
38
-
out there, and then wondering if it's actually making its way to the people who
39
-
need it, and what to do with that old post years and versions down the road.
40
-
You're invited to share that energy to help us bring that ecosystem together
41
-
and grow it further!
42
-
43
-
If you've ever helped anyone, colleague or stranger, with a particular problem,
44
-
then you know the value of having a reference you can quickly link to that says
45
-
"here's how you do it." This site is intended to be that compendium, but
46
-
there's always more to refine and add, and we need your help too!
47
-
48
-
Of course, we'll also give you credit for your work! The **Contributors** section
49
-
for each article is generated from the git commit logs on the file, so you'll
50
-
be publicly acknowledged for your help.
15
+
If you've ever looked for help with jQuery – or with web development in general – you know the hunt can sometimes be challenging. It can be a process of wading through a number of different posts until you find that article that's the right combination of trustworthy, timely, and helpful for your particular problem. And if you're one of those authors – thanks! – then you are probably familiar with the frustrating feeling of putting a useful tip out there, and then wondering if it's actually making its way to the people who need it, and what to do with that old post years and versions down the road. You're invited to share that energy to help us bring that ecosystem together and grow it further!
16
+
17
+
If you've ever helped anyone, colleague or stranger, with a particular problem, then you know the value of having a reference you can quickly link to that says "here's how you do it." This site is intended to be that compendium, but there's always more to refine and add, and we need your help too!
18
+
19
+
Of course, we'll also give you credit for your work! The **Contributors** section for each article is generated from the git commit logs on the file, so you'll be publicly acknowledged for your help.
51
20
52
21
## How Does It Work?
53
22
54
23
### Content
55
24
56
-
The content in this site is maintained in
57
-
[this GitHub repository](http://github.com/jquery/learn.jquery.com) as a collection of
58
-
[Markdown](http://daringfireball.net/projects/markdown/) files in the `page`
59
-
directory. The order in which chapters and articles are presented is controlled
60
-
by the [order.yml](https://github.com/jquery/learn.jquery.com/blob/master/order.yml)
61
-
file.
25
+
The content in this site is maintained in [this GitHub repository](https://github.com/jquery/learn.jquery.com) as a collection of [Markdown](http://daringfireball.net/projects/markdown/) files in the `page` directory. The order in which chapters and articles are presented is controlled by the [order.yml](https://github.com/jquery/learn.jquery.com/blob/master/order.yml) file.
62
26
63
27
### Design
64
28
65
-
The site's layout and design is controlled by our
66
-
[`jquery-wp-content`](http://github.com/jquery/jquery-wp-content), a custom
67
-
[WordPress](http://wordpress.org) configuration that runs (or will run in the
68
-
near future) all of the sites run by the jQuery Foundation. The [master
that controls the templates and styles specific to the learn site.
29
+
The site's layout and design is controlled by our [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content), a custom [WordPress](http://wordpress.org) configuration that runs (or will run in the near future) all of the sites run by the jQuery Foundation. The [master theme](https://github.com/jquery/jquery-wp-content/tree/master/themes/jquery) controls most of the layout for all of our sites, and there is a [child theme](https://github.com/jquery/jquery-wp-content/tree/master/themes/learn.jquery.com) that controls the templates and styles specific to the learn site.
73
30
74
-
[`jquery-wp-content`](http://github.com/jquery/jquery-wp-content) powers our sites in
75
-
production and staging environments, and can set up for local development relatively easily.
31
+
[`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) powers our sites in production and staging environments, and can be set up for local development relatively easily.
76
32
77
33
### Build
78
34
79
-
The static content in the `page` directory is deployed to a
using [grunt](http://gruntjs.com), specifically with two grunt plugins we've created:
82
-
83
-
*[grunt-jquery-content](http://github.com/jquery/grunt-jquery-content) - pre-processes content in a variety of formats (HTML, Markdown, XML) into HTML, applying syntax highlighting and some simple partial support, preparing it for processing by
84
-
*[grunt-wordpress](http://github.com/scottgonzalez/grunt-wordpress) - syncs static content to WordPress using [XML-RPC](http://codex.wordpress.org/XML-RPC_Support)
35
+
The static content in the `page` directory is deployed to a [`jquery-wp-content`](https://github.com/jquery/jquery-wp-content) instance using [grunt](http://gruntjs.com), specifically with two grunt plugins we've created:
85
36
37
+
*[grunt-jquery-content](https://github.com/jquery/grunt-jquery-content) – pre-processes content in a variety of formats (HTML, Markdown, XML) into HTML, applying syntax highlighting and some simple partial support, preparing it for processing by:
38
+
*[grunt-wordpress](https://github.com/scottgonzalez/grunt-wordpress) – syncs static content to WordPress using [XML-RPC](http://codex.wordpress.org/XML-RPC_Support)
86
39
87
40
## How Can I Help?
88
41
89
-
The simplest and least complicated way to help is to [file
90
-
issues](http://github.com/jquery/learn.jquery.com/issues) if you notice
91
-
mistakes that should be fixed, improvements that can be made, or if you have
92
-
ideas for new articles. We'll use the issues to continue discussion and track
93
-
progress on anything you point out.
94
-
95
-
If you'd like to go a step further and contribute new articles, make edits to
96
-
existing ones, or work on the site itself, the first thing you'll need is a
97
-
[fork](https://help.github.com/articles/fork-a-repo). When you have changes
98
-
you'd like to have reviewed for integration into the site, submit a [pull
*(If you're unfamiliar with Git, you can still contribute by using features in
102
-
GitHub's web UI. You can edit files directly via [GitHub's in-browser
103
-
editor](https://github.com/blog/905-edit-like-an-ace). You can [create and
104
-
delete branches directly from your
105
-
fork](https://github.com/blog/1377-create-and-delete-branches), so you can also
106
-
submit new articles as well. Either way, we still encourage you to [learn how
107
-
to use Git and GitHub](http://help.github.com/) as soon as you can.)*
42
+
The simplest and least complicated way to help is to [file issues](https://github.com/jquery/learn.jquery.com/issues) if you notice mistakes that should be fixed, improvements that can be made, or if you have ideas for new articles. We'll use the issues to continue discussion and track progress on anything you point out.
43
+
44
+
If you'd like to go a step further and contribute new articles, make edits to existing ones, or work on the site itself, the first thing you'll need is a [fork](https://help.github.com/articles/fork-a-repo). When you have changes you'd like to have reviewed for integration into the site, submit a [pull request](https://help.github.com/articles/using-pull-requests).
45
+
46
+
*(If you're unfamiliar with Git, you can still contribute by using features in GitHub's web interface. You can edit files directly via [GitHub's in-browser editor](https://github.com/blog/905-edit-like-an-ace). You can [create and delete branches directly from your fork](https://github.com/blog/1377-create-and-delete-branches), so you can also submit new articles as well. Either way, we still encourage you to [learn how to use Git and GitHub](https://help.github.com/) as soon as you can.)*
108
47
109
48
## Local Development
110
49
111
-
In order to preview your changes locally, work on design/layout issues, or work
112
-
on other jQuery sites' content, and generally contribute most effectively, we
113
-
recommend that you set up a local development environment. You can learn how to
114
-
get set up from our [documentation on contributing to jQuery Foundation web
In order to preview your changes locally, work on design/layout issues, or work on other jQuery sites' content, and generally contribute most effectively, we recommend that you set up a local development environment. You can learn how to get set up from our [documentation on contributing to jQuery Foundation web sites](http://contribute.jquery.org/web-sites/#local-development).
116
51
117
-
***Windows note:** Line endings need to be Unix-style (line-feed only). Make
118
-
sure your text editor creates new files with Unix-style line endings. In
119
-
addition, the following setting to your git config will keep the Unix-style
120
-
line endings when pulling from the repository.*
52
+
***Windows note:** Line endings need to be Unix-style (line-feed only). Make sure your text editor creates new files with Unix-style line endings. In addition, the following setting to your git config will keep the Unix-style line endings when pulling from the repository:
121
53
122
54
```
123
55
$ git config --global core.autocrlf true
124
56
```
125
57
126
-
### Working With Content
58
+
### Working with Content
127
59
128
60
Once you've gotten your environment working, here are the general steps you should follow to make your changes:
129
61
130
-
1. Create a new "feature" branch based on `master` --`git branch <feature/issue name/number>`
131
-
2. Move onto that branch --`git checkout <feature/issue name/number>`
62
+
1. Create a new "feature" branch based on `master`:`git branch <feature/issue name/number>`
63
+
2. Move onto that branch:`git checkout <feature/issue name/number>`
132
64
3. Work on your awesome contribution.
133
-
4. As you work and want to preview your changes, use `grunt` to deploy them to the your site. You can also use `grunt watch` to have the site monitor the `page` directory for any changes and automatically have the changes deployed every time you save.
134
-
5. When you're done, stage the new/modified preparation for commit --`git add page/faq/how-do-i-add-a-new-article-to-the-learn-site.md`
135
-
6. Commit the files to your local repo --`git commit -m "add a relevant message describing the change"`
136
-
7. Push the files to your GitHub remote --`git push origin <feature/issue name/number>`
65
+
4. As you work and want to preview your changes, use `grunt` to deploy them to your site. You can also use `grunt watch` to have the site monitor the `page` directory for any changes and automatically have the changes deployed every time you save.
66
+
5. When you're done, stage the new/modified preparation for commit:`git add page/faq/how-do-i-add-a-new-article-to-the-learn-site.md`
67
+
6. Commit the files to your local repo:`git commit -m "add a relevant message describing the change"`
68
+
7. Push the files to your GitHub remote:`git push origin <feature/issue name/number>`
137
69
8. Go to your fork on GitHub and submit a new [pull request](https://help.github.com/articles/using-pull-requests).
138
70
139
-
For more advice on managing your fork and submitting pull requests to jQuery
For more advice on managing your fork and submitting pull requests to the jQuery Foundation, read our [Commits and Pull Requests](http://contribute.jquery.org/commits-and-pull-requests/) guide.
142
72
143
-
### Adding A New Article
73
+
### Adding a New Article
144
74
145
-
1. Add the file to the right folder in the page folder.
146
-
2. Add the slug name (the filename without the extension) to the desired location `order.yml`
75
+
1. Add the file to the right folder in the `page` folder.
76
+
2. Add the slug name (the filename without the extension) to the desired location in `order.yml`
147
77
3. Run `grunt`
148
78
4. You should now be able to navigate to the file.
149
79
150
80
### Formatting Articles
151
81
152
-
Yes! Take a look at our [style guide](http://learn.jquery.com/style-guide) for
153
-
more information on authoring and formatting conventions.
82
+
Yes! Take a look at our [style guide](http://learn.jquery.com/style-guide) for more information on authoring and formatting conventions.
154
83
155
84
## How Will My Contribution Be Acknowledged?
156
85
157
-
We will build the attribution of an article based on the git commit logs and present this information in the site.
86
+
We will build the attribution of an article based on the git commit logs and present this information on the site.
158
87
159
-
## <aname="getting-help">Getting Help</a>
88
+
<h2id="getting-help">Getting Help</h2>
160
89
161
90
If you're struggling to get any part of the site working properly, or have any questions, we're here to help.
162
91
163
-
The best place to get help is on [IRC](http://en.wikipedia.org/wiki/Internet_Relay_Chat), in the #jquery-content
164
-
channel on [Freenode](http://freenode.net). If you're unfamiliar with IRC, you can use the [webchat gateway](http://webchat.freenode.net/).
92
+
The best place to get help is on [IRC](http://en.wikipedia.org/wiki/Internet_Relay_Chat), in the `#jquery-content` channel on [Freenode](http://freenode.net). If you're unfamiliar with IRC, you can use the [webchat gateway](http://webchat.freenode.net/).
165
93
166
-
In addition, the jQuery Content Team holds a [public, weekly
167
-
meetings](http://jquery.org/meeting) on Freenode, at 1PM Eastern time in the #jquery-meeting channel.
94
+
In addition, the jQuery Content Team holds a [public, weekly meetings](http://jquery.org/meeting) on Freenode, at 1PM Eastern time in the `#jquery-meeting` channel.
168
95
169
-
If IRC is not your thing, but you still want or need to get in touch, please use the site's GitHub repo or send us an e-mail to `content at jquery dot org`.
96
+
If IRC is not your thing, but you still want or need to get in touch, please use the site's [GitHub repo](https://github.com/jquery/learn.jquery.com) or send us an e-mail to `content at jquery dot org`.
0 commit comments