# Contributing We're so glad you're thinking about contributing to an FPAC open source project! If you're unsure about anything, just ask — submit your issue or pull request anyway. The worst that can happen is we'll politely ask you to change something. We appreciate all friendly contributions, whether they be from FPAC collaborators or citizens alike. One of our goals is to ensure a welcoming environment for all contributors to our projects. Our staff follows the [FSA Employee Responsibilities and Conduct](http://www.fsa.usda.gov/FSA/hrdapp?area=home&subject=labr&topic=erc), and all contributors should do the same. ## Guidelines ### Submitting an issue To help us get a better understanding of the issue you're submitting, follow our ISSUE TEMPLATE and the guidelines it describes. ### Submitting a pull request Here are a few guidelines to follow when submitting a pull request: 1. Create a GitHub account or sign in to your existing account. 1. Fork this repo into your GitHub account (or just clone it if you're a member of the FPAC , nee USDA-FSA, GitHub Organization). Read more about [forking a GitHub repository](https://help.github.com/articles/fork-a-repo). 1. Create a branch that lightly defines what you're working on (for example, `proposed-foo-styles`). 1. Ensure that your contribution works via `npm`, if applicable. See below under _Install the package locally via `npm-link`_. 1. Once you're ready to submit a pull request, fill out the PULL REQUEST template provided. 1. Submit your pull request against the [gh-pages-dev](https://github.com/USDA-FSA/fsa-design-system/tree/gh-pages-dev) branch. ### Building fsa-style locally with Grunt The FPAC Design System's [fsa-style](https://github.com/USDA-FSA/fsa-style) package (the ZIP download or contents of published NPM module) and Design System website (our public site that displays examples of each component and the HTML code) are built using Grunt automation. To use Grunt, first make sure you've installed it on your machine globally. ```sh npm install --global grunt-cli ``` Then, to start, run the following command to install any new dependencies and run the default Grunt task: ```sh npm start ``` ## Licenses and attribution ### A few parts of this project are not in the public domain The Source Sans Pro font files in `assets/fonts` are a customized subset of [Source Sans Pro](https://github.com/adobe-fonts/source-sans-pro), licensed under the [SIL Open Font License](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL), and copyright [Adobe Systems Incorporated](http://www.adobe.com), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe Systems Incorporated in the United States and/or other countries. The Merriweather font files in `assets/fonts` are from [Google Web Fonts](https://www.google.com/fonts#UsePlace:use/Collection:Merriweather:400,300,400italic,700,700italic), licensed under the [SIL Open Font License](http://scripts.sil.org/cms/scripts/page.php?item_id=OFL), and copyright [Sorkin Type Co](www.sorkintype.com) with Reserved Font Name 'Merriweather'. The files in `assets/img` are from [Font Awesome](http://fontawesome.io) by Dave Gandy under the [SIL Open Font License 1.1](http://scripts.sil.org/OFL). The files in `assets/_scss/lib/bourbon` are from [Bourbon](http://bourbon.io), copyright [thoughtbot](https://thoughtbot.com), inc., under the [MIT license](https://github.com/thoughtbot/neat/blob/master/LICENSE.md). The files in `assets/_scss/lib/neat` are from [Neat](http://neat.bourbon.io), copyright [thoughtbot](https://thoughtbot.com), inc., also under the [MIT license](https://github.com/thoughtbot/neat/blob/master/LICENSE.md). The file `assets/css/normalize.min.css` is from [Normalize.css](https://github.com/necolas/normalize.css), copyright Nicolas Gallagher and Jonathan Neal, under the [MIT license](https://github.com/necolas/normalize.css/blob/master/LICENSE.md). The file `assets/js/component.js` includes `politespace.js` from [Politespace](https://github.com/filamentgroup/politespace), copyright Zach Leatherman, under the [MIT license](https://github.com/filamentgroup/politespace/blob/master/LICENSE). The file `assets/js/vendor/html5shiv.js` is from [HTML5 Shiv](https://github.com/afarkas/html5shiv), copyright Alexander Farkas (aFarkas), under the [MIT license](https://github.com/aFarkas/html5shiv/blob/master/MIT%20and%20GPL2%20licenses.md). The file `assets/js/vendor/jquery-1.11.3.min.js` is from [jQuery](https://jquery.com), copyright The jQuery Foundation, under the [MIT license](https://jquery.org/license). The file `assets/js/vendor/rem.min.js` is from [REM unit polyfill](https://github.com/chuckcarpenter/REM-unit-polyfill), copyright Chuck Carpenter, under the [MIT license](https://github.com/chuckcarpenter/REM-unit-polyfill/blob/master/LICENSE.md). The file `assets/js/vendor/respond.js` is from [Respond.js](https://github.com/scottjehl/Respond), copyright Scott Jehl, under the [MIT license](https://github.com/scottjehl/Respond/blob/master/LICENSE-MIT). The file `assets/js/vendor/selectivizr-min.js` is from [Selectivizr](http://selectivizr.com), copyright Keith Clark, under the [MIT license](http://opensource.org/licenses/mit-license.php). The files `assets-styleguide/js/vendor/prism.js` and `assets-styleguide/css/prism.css` are from [Prism](http://prismjs.com), copyright Lea Verou, under the [MIT license](https://github.com/PrismJS/prism/blob/gh-pages/LICENSE). ### The rest of this project is in the public domain The rest of this project is in the worldwide [public domain](LICENSE.md). This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0). All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.