Contribution guidelines should go into contributing.md #5

Closed
tkellen opened this Issue Oct 15, 2012 · 13 comments

Projects

None yet

6 participants

@tkellen
Member
tkellen commented Oct 15, 2012

add this to all applicable templates.

see gruntjs/grunt#433

@vladikoff
Member

Updated the title of this, if anyone wants to work on this comment on this issue. Marked as "needs PR".

@jrrickard

I have some time to work on this.

@vladikoff
Member

@jrrickard Awesome! Let us know if you need any details or help for the pull request :)

@jrrickard

I think I've got it, I'll summarize and you can tell me if I am wrong :)

The officially supported init templates should all get contribution guidelines added so users end up with a contributing.md file. Looks like the jquery template has it?

https://github.com/gruntjs/grunt-init-jquery/blob/master/root/CONTRIBUTING.md

I forked all the repos and added a file to root/updated the README template for everything else (jquery already had it). I'll make a PR if that's right.

@vladikoff
Member

@jrrickard seems right. // @tkellen any feedback regarding this?

@shama
Member
shama commented Dec 19, 2013

Some of the guidelines would need to be a little different. Such as only grunt-init-jquery uses phantomjs. grunt-init-node and grunt-init-commonjs generate a lib/ folder (instead of a src and dist). grunt-init-gruntplugin generates a tasks/ folder.

This line:

Open test/*.html unit test file(s) in actual browser to ensure tests pass everywhere.

Would only apply to grunt-init-jquery as well.

Thanks!

@jrrickard

@shama Yeah, I reworded them a little bit so they were slightly more generic, since they are all pretty similar (except the lib vs tasks directory generation). the run grunt-init node line is actually different for each of the templates. Let me know if this is good and I'll make the PR.

Contributing

Contribution Guide

See the wiki for the complete contribution guide.

Code style

Regarding code style like indentation and whitespace, follow the conventions you see used in the source already.

Modifying the code

First, ensure that you have the latest Node.js and npm installed.

Test that Grunt's CLI is installed by running grunt --version. If the command isn't found, run npm install -g grunt-cli. For more information about installing Grunt, see the getting started guide.

Submitting pull requests

  1. Create a new branch, please don't work in your master branch directly.
  2. Clone the repo into ~./grunt-init
  3. Fix stuff.
  4. Run grunt-init node on a new directory
  5. Run npm install to install all dependencies
  6. Run grunt to grunt the new template code
  7. Repeat until no errors.
  8. Update the documentation to reflect any changes.
  9. Push to your fork and submit a pull request.
@shama
Member
shama commented Dec 20, 2013

Nice Jeremy, looks good. Except I don't know if steps 2, 4 and the wording in 6 will apply to the contributing guide here. As they are intended as a starting point for new projects as opposed to contributing guidelines for the grunt-init projects.

@vladikoff
Member

@jrrickard could that be updated and sent as a pull request?

@jrrickard

@vladikoff yep, sorry for the delay. I got pretty sick before Christmas. Working on the PR now.

@vladikoff
Member

@jrrickard ah no worries, Hope all is well now! 🎉

@auscaster

@jrrickard are you still working on this?

@imjacobclark
Contributor

Implemented this change in PR #89, feedback? 😄

@vladikoff vladikoff closed this Dec 3, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment