Skip to content

Conversation

@shockey
Copy link
Contributor

@shockey shockey commented Jul 25, 2017

Fixes #3014.

Here's my proposal for a Contributing Guidelines document.

CONTRIBUTING.md Outdated
#### Environment setup

0. Install Node.js (4 or newer) and npm (3 or newer).
1. Fork Swagger-UI, and clone your fork.
Copy link
Contributor

Choose a reason for hiding this comment

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

double clone?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@ponelat intended to write: Make a fork of Swagger-UI on GitHub, then clone your fork to your machine.

Will change for clarity, thx!

CONTRIBUTING.md Outdated
- Do not end the subject line with a period.
- Use the imperative mood in your subject lines, as if you were giving the code an order in your subject line.
- This mimics what Git does for you automatically: "Merge develop", "Revert f570ffc", etc
- Simple trick... your subject line should complete this sentence: `If applied, this commit will [your subject line].`
Copy link
Contributor

Choose a reason for hiding this comment

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

This is an awesome tip.
Would it make sense to use your tip, plus maybe two other points? I think the guide may be larger than needed, IMO.

Copy link
Contributor

@owenconti owenconti left a comment

Choose a reason for hiding this comment

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

LGTM

@EWhite613
Copy link

EWhite613 commented Aug 9, 2017

Would this file make more sense to be located in .github/CONTRIBUTING.md? Then you'll get the warning above a PR when ur about to create that reminds you to Before you create a pull request, please review [the guidelines for contributing](link) to this repository.

@shockey
Copy link
Contributor Author

shockey commented Aug 9, 2017

@EWhite613, looks like that's how it was originally done (see https://github.com/github/github-services/blob/master/.github/CONTRIBUTING.md for an example). I recall that being the case in the not too distant past.

I'm going off of https://help.github.com/articles/setting-guidelines-for-repository-contributors/, which states:

To help your project contributors do good work, you can add a file with contribution guidelines to your project repository's root, docs, or .github folder.Then, whenever someone opens a pull request or creates an issue, they will see a link to that file.

@shockey shockey merged commit e1a49ee into swagger-api:master Aug 11, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants