Repository files navigation

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 theUSDA Employee Responsibilities and Conduct, and all contributors should do the same.

To help us get a better understanding of the issue you're submitting, follow our ISSUE TEMPLATE and the guidelines it describes.

Here are a few guidelines to follow when submitting a pull request:

1. Create a GitHub account or sign in to your existing account.
2. Fork this repo into your GitHub account (or just clone it if you're a member of the USDA-FSA GitHub Organization). Read more aboutforking a GitHub repository.
3. Create a branch that lightly defines what you're working on (for example,proposed-foo-styles).
4. Ensure that your contribution works vianpm, if applicable. See below underInstall the package locally vianpm-link.
5. Once you're ready to submit a pull request, fill out the PULL REQUEST template provided.
6. Submit your pull request against thegh-pages-dev branch.

The Design System'sfsa-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.

npm install --global grunt-cli

Then, to start, run the following command to install any new dependencies and run the default Grunt task:

npm start

The Source Sans Pro font files inassets/fonts are a customized subset ofSource Sans Pro, licensed under theSIL Open Font License, and copyrightAdobe Systems Incorporated, 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 inassets/fonts are fromGoogle Web Fonts, licensed under theSIL Open Font License, and copyrightSorkin Type Co with Reserved Font Name 'Merriweather'.

The files inassets/img are fromFont Awesome by Dave Gandy under theSIL Open Font License 1.1.

The files inassets/_scss/lib/bourbon are fromBourbon, copyrightthoughtbot, inc., under theMIT license.

The files inassets/_scss/lib/neat are fromNeat, copyrightthoughtbot, inc., also under theMIT license.

The fileassets/css/normalize.min.css is fromNormalize.css, copyright Nicolas Gallagher and Jonathan Neal, under theMIT license.

The fileassets/js/component.js includespolitespace.js fromPolitespace, copyright Zach Leatherman, under theMIT license.

The fileassets/js/vendor/html5shiv.js is fromHTML5 Shiv, copyright Alexander Farkas (aFarkas), under theMIT license.

The fileassets/js/vendor/jquery-1.11.3.min.js is fromjQuery, copyright The jQuery Foundation, under theMIT license.

The fileassets/js/vendor/rem.min.js is fromREM unit polyfill, copyright Chuck Carpenter, under theMIT license.

The fileassets/js/vendor/respond.js is fromRespond.js, copyright Scott Jehl, under theMIT license.

The fileassets/js/vendor/selectivizr-min.js is fromSelectivizr, copyright Keith Clark, under theMIT license.

The filesassets-styleguide/js/vendor/prism.js andassets-styleguide/css/prism.css are fromPrism, copyright Lea Verou, under theMIT license.

The rest of this project is in the worldwidepublic domain.

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through theCC0 1.0 Universal public domain dedication.

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.