-
Notifications
You must be signed in to change notification settings - Fork 7
Submit a PR that adds community standard docs
Greg Swindle edited this page Sep 6, 2017
·
2 revisions
- 1. Fork the Git repository
- 2. Clone the forked repository
- 3. Create a new
docs/community-standards
branch - 4. Add the boilerplate templates to the root directory
- 5. Add the documents to Git
- 6. Commit and stage the documents
- 7. Push the documents to
origin
- 8. Submit a pull request (PR)
If you have write access to the repository, you can clone the repository, instead. Otherwise, fork the repository of interest to your personal organization (in GitHub or BitBucket).
git clone https://hostname.com/path/to/repo.git
cd repo/
git checkout -b docs/community-standards
mkdir -p docs/img/
cp /path/to/generator-community-repo.wiki/docs/img/ ./docs/img/
cp /path/to/generator-community-repo.wiki/*.md ./
git add .
git commit -m "docs(community-repo): add inner/open source templates
Build a community that encourages people to use, contribute to, and evangelize
your product with these recommended community standards
(https://opensource.guide/):
1. README.md: The repo's home page with _consumption_ instructions
2. CONTRIBUTING.md: The instruction manual for _contributions_
3. CODE_OF_CONDUCT.md: Instructions for community _behavior_
4. LICENSE: : Mitigate consumer/contributor legal risks (**not included**)
* **TODO:** Replace README.md and CONTRIBUTING.md's placeholder text with your product delivery team's custom instructions.
* **TODO:** Replace the following string in all documents with your product's name:
product-name
"
git push origin docs/community-standards
docs(community-repo): add inner/open source templates
Add the following Git comment to your PR.
Build a community that encourages people to use, contribute to, and evangelize your product with these recommended community standards (https://opensource.guide/):
1. README.md: The repo's home page with _consumption_ instructions
2. CONTRIBUTING.md: The instruction manual for _contributions_
3. CODE_OF_CONDUCT.md: Instructions for community _behavior_
4. LICENSE: : Mitigate consumer/contributor legal risks (**not included**)
* **TODO:** Replace README.md and CONTRIBUTING.md's placeholder text with your product delivery team's custom instructions.
* **TODO:** Replace the following string in all documents with your product's name:
product-name
## Description of changes
1. Add [GitHub's recommended community standards](https://opensource.guide/) documents in order to encourage people to use, contribute to, and evangelize our products (as well as return meaningful search results).
2. Include an _optional_ CHANGELOG.md to encourage the team to [consider commit message conventions that enable automated CHANGELOG generation and updates](https://github.com/conventional-changelog/standard-version).
3. Include sample MIT open source LICENSE: , which is not required for inner source products, but a [crucial consideration should you ever decide to open source your product](https://opensource.guide/legal/).
### Associated issue(s)
__N/A__. Just a friendly helping hand from the VZ Inner and Open Source Program 👨👧👦 .
- [ ] The acceptance criteria for all associated issues have been completed, tested, and validated.
### PR check-list
> **✅ Please review and check the appropriate items.**
#### 1. Next steps
##### 1.1. README.md
- [ ] The README's content provides usage instructions.
- [ ] The README describes our team's Git collaboration model and how to contribute.
##### 1.2. CONTRIBUTING.md
- [ ] The CONTRIBUTING guidelines provide detailed, unambiguous instructions that allow anyone in Verizon to contribute to your product and community.
This work is licensed under a Creative Commons Attribution 4.0 International License.
Graph art by icons8.
-
CODE_OF_CONDUCT
Facilitate healthy community behavior. -
CONTRIBUTING
Detailed participation guidelines. -
LICENSE
Select an open source license. -
README
Your repo's home page.
- InnerSource Commons
paypal/InnerSourcePatterns
- Submit a PR that adds community-standard docs
- Release cheatsheet