Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs: Reduce contributing guidelines by linking to contribute.jquery.org #1161

Closed
wants to merge 7 commits into from

Conversation

scottgonzalez
Copy link
Member

This is an initial attempt to reduce our contributing guidelines by offloading the majority of the documentation to our centralized contribution documentation, http://contribute.jquery.org. @jzaefferer and I spent some time this morning fleshing out http://contribute.jquery.org/code/ and the associated pages (currently only on stage). I'd like to do this for our larger projects, which all have pretty lengthy contributing guidelines.

@ajpiano
Copy link
Member

ajpiano commented Jan 6, 2014

👍

@jaspermdegroot
Copy link
Member

For info about the forums and IRC you can link to the support page on the project website.


## Discussion

### Forum and IRC

The jQuery UI development team frequently tracks posts on the [Developing jQuery UI Forum](http://forum.jquery.com/developing-jquery-ui). If you have longer posts or questions please feel free to post them there. If you think you've found a bug please [file it in the bug tracker](#how-to-report-bugs).
The jQuery UI development team frequently tracks posts on the [Developing jQuery UI Forum](http://forum.jquery.com/developing-jquery-ui). If you have longer posts or questions please feel free to post them there. If you think you've found a bug please [file it in the bug tracker](http://contribute.jquery.org/bug-reports/).

Additionally most of the jQuery UI development team can be found in the [#jqueryui-dev](http://webchat.freenode.net/?channels=jqueryui-dev) IRC channel on irc.freenode.net.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is now redundant as you mention #jqueryui-dev on line #7.

@tjvantoll
Copy link
Member

Other than my few trivial comments this looks good.

@scottgonzalez
Copy link
Member Author

Updated based on feedback from @tjvantoll and @uGoMobi.

@tjvantoll
Copy link
Member

👍


You may also want to take a look at our [commit & pull request guide](http://contribute.jquery.org/commits-and-pull-requests/) and [style guides](http://contribute.jquery.org/style-guide/) for instructions on how to maintain your fork and submit your code. Before we can merge any pull request, we'll also need you to sign our [contributor license agreement](http://contribute.jquery.org/cla).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's put the CLA sentence first.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is common boilerplate. If we update the order here, we'll need to update it in a few dozen repos.

@@ -91,25 +40,25 @@ Change directory to your web root directory, whatever that might be:
$ cd /path/to/your/www/root/
```

Clone your jQuery UI fork to work locally
Clone your jQuery UI fork to work locally.

```bash
$ git clone git@github.com:username/jquery-ui.git
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

$ git clone git@github.com:[USERNAME]/jquery-ui.git

to make it more obvious that this line as-is won't work and has to be edited

@scottgonzalez
Copy link
Member Author

I believe all comments have been addressed. @jzaefferer Please do another round of review.

* Grunt (install with: `npm install grunt -g`

* [Node.js](http://nodejs.org/) (includes NPM, necessary for the next step)
* Grunt (install with: `npm install -g grunt`

Maintaining a list of platform specific instructions is outside of the scope of this document and there is plenty of existing documentation for the above technologies.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we link to MAMP/XAMPP above, we can remove this line.

@jzaefferer
Copy link
Member

Good to land, with or without the HTTP server links.

@scottgonzalez
Copy link
Member Author

Added links for XAMPP and MAMP in 08db028.

@scottgonzalez scottgonzalez deleted the contributing branch July 2, 2014 21:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants