Skip to content

docs(CONTRIBUTING.md): Clarify contribution process - #195

Merged
jeff-phillips-18 merged 3 commits into
patternfly:masterfrom
jgiardino:contributing
Feb 19, 2018
Merged

jeff-phillips-18 merged 3 commits into
patternfly:masterfrom
jgiardino:contributing

Conversation

@jgiardino

Copy link
Copy Markdown
Contributor

Clarify contribution process related to using the project board, labels, creating issues, and adding
less/sass files.

What: Updates CONTRIBUTING.md

Link: https://github.com/jgiardino/patternfly-react/blob/contributing/CONTRIBUTING.md

Clarify contribution process related to using the project board, labels, creating issues, and adding
less/sass files.
@jgiardino

Copy link
Copy Markdown
Contributor Author

@priley86 - for issue #105, were there specific updates that you wanted to include in CONTRIBUTING.md as a result of the updates you made in #101?

@serenamarie125 serenamarie125 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@jgiardino you've done a great job with this. I have a few minor questions/suggestions.

Comment thread CONTRIBUTING.md Outdated

1. If the component does not yet exist as a PatternFly component, check the [PatternFly Decision Tree](https://github.com/patternfly/patternfly-design/blob/master/resources/decision-tree/PatternflyDecisionTree.pdf) to see if your component meets the criteria for an addition to PatternFly. If you're unsure, reach out to us on the [email protected] mailing list.
2. If the component exists in PatternFly or passes the Decision Tree, then create an issue with the following details:
1. Assign the label `enhancement` to the issue

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@jgiardino formatting of this doesn't seem correct.

Comment thread CONTRIBUTING.md

To create an issue for adding a new component to the repo, please observe the following process:

1. If the component does not yet exist as a PatternFly component, check the [PatternFly Decision Tree](https://github.com/patternfly/patternfly-design/blob/master/resources/decision-tree/PatternflyDecisionTree.pdf) to see if your component meets the criteria for an addition to PatternFly. If you're unsure, reach out to us on the [email protected] mailing list.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@jgiardino trying to figure out what this means ... is this implementation of something which is not yet a documented PatternFly design pattern?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yes — components that don't exist yet in patternfly core could be added to patternfly react assuming they pass the pf decision tree, so that these contributions aren't blocked.

Comment thread CONTRIBUTING.md Outdated
2. If the component exists in PatternFly or passes the Decision Tree, then create an issue with the following details:
1. Assign the label `enhancement` to the issue
2. Include the text “Component -“ in the beginning of the title if the issue captures a new component
3. If the component currently exists in patternfly, include a link to it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Could we reword this to

If the component is documented as a PatternFly Pattern Library, include a link to it.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

👍

@priley86

Copy link
Copy Markdown
Member

@jgiardino this looks good to me and agree w/ @serenamarie125 's comments. I made a few slight tweaks to the PR template in #101, but it looks like those are already covered in this last section of this contribution guide - "Please be sure to include all of the following in your PR:". The PR template now has similar language which hopefully helps new contributors deploy their storybook correctly.

@jgiardino

Copy link
Copy Markdown
Contributor Author

@jeff-phillips-18 I updated the section "Adding Styling for your Components." Can you confirm if these updates are accurate?

@jeff-phillips-18 jeff-phillips-18 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@jgiardino

Copy link
Copy Markdown
Contributor Author

Hey @serenamarie125,
Will you take a look and let me know if you have any further suggestions?

@jeff-phillips-18
jeff-phillips-18 merged commit 700364e into patternfly:master Feb 19, 2018
@jgiardino jgiardino removed the review label Feb 19, 2018
@jeff-phillips-18

Copy link
Copy Markdown
Member

@serenamarie125 Merged this PR, if you have any further issues/suggestions please open a new issue.

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.

4 participants