Thanks for considering contributing to normalize-opentype.css!
If you’re new to all this GitHub, Open Source, JavaScript, Node.js, testing, wow all this stuff seems really difficult I just want to make my sites better stuff, I get it. I’m still there, too.
Feel free to send me an email or open an issue here and I’ll do my best to share some resources that have helped me out. No promises—I’m still learning, too—but I can say it would be great to have you stay around, or be involved in any capacity, if you’re interested.
If you find a bug, please feel free to open an issue.
If you taking the time to mention a problem, even a seemingly minor one, it is greatly appreciated, and a totally valid contribution to this project. Thank you!
We love pull requests. Here’s a quick guide:
- Fork this repository and then clone it locally:
git clone https://github.com/kennethormandy/normalize-opentype.css
cd normalize-opentype
npm install
- Create a topic branch for your changes:
git checkout -b fix-for-that-thing
- Add a failing test for the bug.
Normalize-OpenType.css follows Normalize.css’s lead and uses SUIT CSS’ test library. Create a test case that shows the issue you discovered in test/index.html
.
git commit -am "Adds a failing test to demonstrate that thing"
- Add a fix that makes the test pass.
Update the normalize-opentype.scss
source file, and recompile it using npm run build
. You can re-run the tests with:
npm test
- Commit the fix
If the UI test you wrote is now passing, commit the fix!
git commit -am "Adds a fix for that thing"
- Everything looks good, so push to your fork:
git push origin fix-for-that-thing
-
Enjoy being the wonderful person you are
After you’ve opened your pull request, you should email me your mailing address so I can mail you a personal thank you note. Seriously!
Thinking of adding a new feature? Cool! Open an issue and let’s design it together.