bourbon 4.2.4 → 6.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5f314dffdd8ed3cfb4a6170d6825614cfa7294e1
-  data.tar.gz: 95dbacf29f1be76e148f10eb49093ee1e3f7d772
+SHA256:
+  metadata.gz: a360bd2567304c4ae49d8e9d97716cd0d3d0abb88a8ede44aa5b68301b479c73
+  data.tar.gz: 485fa493c958cb331bc76eecea565bce515bd36f6290d9c0c92df5baf8e4a343
 SHA512:
-  metadata.gz: cdd828376b51a33ae123103766571cf8d02a5e257426016b18d90aa50bcaca85154bbdee6750b6187756cbd34b5d3bd4b68b98e1ddc7eca36fa30dd4052eff3a
-  data.tar.gz: c554ba1b34e8e340174e9444a43c3ddb53828e5c3012a2ff1df9066dcaae3d711ad740c2e4e087302d85dda5876767ae54a5b3742325767f96a265feeb298af7
+  metadata.gz: bc8960becf33315e221f8f71a6ceab0a94c186b92ae6c5b64e019469ba864837fb30e53af6465121fc39d47da848c2d5f2a1e1dedbe38ed02140252205716871
+  data.tar.gz: 6e55d39b9925e3b745a2722b818469e6e8b37a295c833bf82c91c6d986fdb262ecbffb4ebef09b4c8cf55ff489290b12cfc19eef72c9645660db32dbdc88037d

data/.circleci/config.yml

@@ -0,0 +1,34 @@
+version: 2
+
+jobs:
+  build:
+    docker:
+      - image: circleci/ruby:2.6.3-node
+
+    steps:
+      - checkout
+
+      - restore_cache:
+          keys:
+            - bourbon-{{ arch }}-{{ checksum "bourbon.gemspec" }}
+
+      - run:
+          name: Install Ruby dependencies
+          command: bundle install --path vendor/bundle
+
+      - run:
+          name: Install SassDoc
+          command: sudo npm install -g sassdoc@2.5.0
+
+      - save_cache:
+          key: bourbon-{{ arch }}-{{ checksum "bourbon.gemspec" }}
+          paths:
+            - vendor/bundle
+
+      - run:
+          name: Run the tests
+          command: bundle exec rake
+
+      - run:
+          name: Parse SassDoc comments
+          command: sassdoc core/ --parse --verbose --strict

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,22 @@
+<!-- Feel free to remove any part of this issue template that is not relevant -->
+<!-- Providing context helps us come up with a useful solution -->
+
+## Description
+
+<!-- What did you expect to happen? What happened instead? Was a specific error thrown? -->
+
+## Steps to Reproduce
+
+<!-- If you can reproduce the bug in a CodePen, link to it here -->
+
+1. Step 1…
+2.
+3.
+
+## Development Environment
+
+<!--- Include as many relevant details about the environment you experienced the bug in -->
+
+- Bourbon version:
+- Platform:
+- Link to the code repository:

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+<!-- Feel free to remove any part of this pull request template that is not relevant -->
+
+## Description
+
+<!-- What do your changes do or fix? -->
+
+## Additional Information
+
+<!-- Links to demos, e.g. CodePen, can be helpful, as are research and support documents -->
+<!-- If this fixes or is related to an existing issue, link to it here (and in the commit message) -->

data/.gitignore

@@ -5,4 +5,4 @@
 _site
 Gemfile.lock
 npm-debug.log
-tmp
+tmp/

data/.hound.yml

@@ -1,5 +1,7 @@
 ruby:
   enabled: true
 scss:
-  config_file: .scss-lint.yml
+  enabled: false
+stylelint:
+  config_file: .stylelintrc.json
   enabled: true

data/.npmignore

@@ -1,17 +1,20 @@
+.circleci/
+.github/
 .gitignore
 .hound.yml
+.ruby-version
 .sass-cache
-.scss-lint.yml
-.travis.yml
+.stylelintrc.json
 _site
 bin/
 bourbon.gemspec
-bower.json
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
 features/
 Gemfile
 Gemfile.lock
 lib/
 pkg/
 Rakefile
-sache.json
+RELEASING.md
 spec/

data/.stylelintrc.json

@@ -0,0 +1,3 @@
+{
+  "extends": "@thoughtbot/stylelint-config"
+}

data/.tool-versions

@@ -0,0 +1,2 @@
+ruby 2.6.3
+nodejs 10.16.0

data/CHANGELOG.md

@@ -0,0 +1,415 @@
+# Change Log
+
+All notable changes to this project will be documented in this file. This
+project adheres to [Semantic Versioning](http://semver.org).
+
+## [Unreleased (`master`)][unreleased]
+
+Nothing at the moment.
+
+[unreleased]: https://github.com/thoughtbot/bourbon/compare/v6.0.0...HEAD
+
+## [6.0.0] - 2019-07-10
+
+### Removed
+
+- Installation through Bower is no longer supported.
+- The sass gem (the deprecated Ruby Sass) is no longer a runtime dependency.
+
+[6.0.0]: https://github.com/thoughtbot/bourbon/compare/v5.1.0...v6.0.0
+
+## [5.1.0] - 2018-07-20
+
+### Added
+
+- `$font-stack-system` now includes the `system-ui` value.
+
+### Changed
+
+- The `_gamma` function will use a `pow` function, if available.
+
+[5.1.0]: https://github.com/thoughtbot/bourbon/compare/v5.0.1...v5.1.0
+
+## [5.0.1] - 2018-06-08
+
+### Fixed
+
+- Fixed an issue that would cause Bourbon to not be found when using SassC.
+
+[5.0.1]: https://github.com/thoughtbot/bourbon/compare/v5.0.0...v5.0.1
+
+## [5.0.0] - 2018-01-05
+
+Bourbon 5.0.0 is a major release with lots of changes and removals, which are
+documented below in each of the alpha and beta releases. There are no changes
+between v5.0.0-beta.8 and v5.0.0. For information on how to upgrade from v4 to
+v5, read our [migrating guide][migrating-guide].
+
+[5.0.0]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.8...v5.0.0
+[migrating-guide]: https://www.bourbon.io/docs/migrating-from-v4-to-v5/
+
+## [5.0.0-beta.8] - 2017-06-26
+
+### Added
+
+- A `style` property has been added to our `package.json`, which makes for easy
+  importing when using npm-sass, sass-module-importer and others.
+
+### Changed
+
+- The `triangle` mixin no longer has default argument values. The order of the
+  arguments also changed: `$width` and `$height` now come before `$color`.
+
+### Fixed
+
+- The `bourbon update` CLI command now works when Bourbon is installed using a
+  custom path.
+- Fixed an issue that would cause Bourbon to not be found within Rails apps.
+
+[5.0.0-beta.8]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.7...v5.0.0.beta.8
+
+## [5.0.0-beta.7] - 2016-11-03
+
+### Added
+
+- Added `white-space: nowrap;` to the `hide-visually` mixin so that content
+  renders on one line and is correctly pronounced by screen readers. You can
+  read more about this in Jesse Beach’s article “[Beware smushed off-screen
+    accessible text][smushed-text-article].”
+
+### Changed
+
+- Removed the default values from the `$position` and `$coordinates` arguments
+  for the `position` mixin.
+- Updated `contrast-switch` to calculate contrast based on the WCAG 2.0
+  specification. Please note that it is an approximation and we cannot guarantee
+  full compliance, though all of our manual testing passed.
+- Renamed the `$coordinates` argument in the `position` mixin
+  to `$box-edge-values`.
+- Updated `$font-stack-system` to include Avenir Next, Avenir, Lucida
+  Grande, Helvetica, Noto, Franklin Gothic Medium, Century Gothic, and
+  Liberation Sans. This follows [system-fonts] by Adam Morse.
+- The `word-break` property was removed from the `word-wrap` mixin and
+  is no longer output.
+- Renamed the `word-wrap` mixin to `overflow-wrap` to align with the
+  name change in the [CSS spec].
+
+[smushed-text-article]: https://medium.com/@jessebeach/beware-smushed-off-screen-accessible-text-5952a4c2cbfe#.l4hkljiza
+[system-fonts]: https://github.com/mrmrs/css-system-fonts
+[CSS spec]: https://drafts.csswg.org/css-text-3/#propdef-overflow-wrap
+
+[5.0.0-beta.7]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...v5.0.0.beta.7
+
+## [5.0.0-beta.6] - 2016-06-06
+
+### Added
+
+- Added a `value-prefixer` mixin for generating vendor prefixes on values.
+
+[5.0.0-beta.6]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.5...v5.0.0.beta.6
+
+## [5.0.0-beta.5] - 2016-03-23
+
+### Fixed
+
+- Fixed a Sass load path issue that would intermittently break the importing of
+  Bourbon in Rails apps.
+
+### Changed
+
+- Swapped the order of the `$file-formats` and `$asset-pipeline` arguments in
+  the `font-face` mixin, so that `$asset-pipeline` is last (because it has a
+  default and is likely used the least).
+
+[5.0.0-beta.5]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.4...v5.0.0.beta.5
+
+## [5.0.0-beta.4] - 2016-03-11
+
+### Fixed
+
+- We accidentally published `5.0.0.beta.3` as a stable release on npm, rather
+  than a prerelease. We’ve unpublished that to go back to `4.2.6` on the stable
+  channel.
+
+[5.0.0-beta.4]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.3...v5.0.0.beta.4
+
+## [5.0.0-beta.3] - 2016-03-04
+
+### Fixed
+
+- Added `pathname` requirement to fix install issues.
+
+[5.0.0-beta.3]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.2...v5.0.0.beta.3
+
+## [5.0.0-beta.2] - 2016-03-03
+
+### Added
+
+- Added global settings for the `contrast-switch` mixin:
+  `contrast-switch-dark-color` & `contrast-switch-light-color`.
+- Added the `triangle` mixin back, but note that it’s been refactored and the
+  arguments have changed. See [43e5a90].
+
+### Changed
+
+- Switched argument names in `contrast-switch`; `$dark-color` is now
+  `$light-color` and `$light-color` is now `$dark-color`.
+- The `is-light` function is now private.
+
+### Removed
+
+- Dropped support for Ruby on Rails versions older than 4.2.
+- Dropped support for LibSass versions older than 3.3.
+
+[5.0.0-beta.2]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.1...v5.0.0.beta.2
+[43e5a90]: https://github.com/thoughtbot/bourbon/commit/43e5a90e7e624d2977731030ccdb36b3c2e460d9
+
+## [5.0.0-beta.1] - 2016-02-09
+
+### Added
+
+- Added a `contrast-switch` function that switches between two colors based on the
+  lightness of a another color. Great for building button styles.
+- Added an `$all-text-inputs-invalid` variable to target the `:invalid`
+  pseudo-class on all text-based inputs.
+- The `ellipsis` mixin now takes a `$display` argument.
+- Added a font stack for system fonts: `$font-stack-system`.
+- Added a `hide-visually` mixin that hides an element visually while still
+  allowing the content to be accessible to assistive technology,
+  e.g. screen readers.
+- The `font-face` mixin now allows additional CSS properties to be included in
+  its block, which will output as part of the `@font-face` declaration.
+  See [2356719].
+
+### Changed
+
+- The global default for the `modular-scale` ratio is now set to
+  `$major-third` (`1.25`), instead of `$perfect-fourth` (`1.333`).
+- All font stack variables are now prefixed with `$font-stack-`,
+  e.g. `$font-stack-helvetica`.
+- Global settings are now set via a `$bourbon` map, instead of variables.
+  See [4e43c2d].
+- The `clearfix` mixin now uses `block` display, instead of `table`.
+
+### Removed
+
+- The `$weight` and `$style` arguments in the `font-face` mixin have been
+  removed. Instead, you can now include these—along with other CSS
+  properties—within the mixin block and they’ll be output as part of the
+  `@font-face` declaration.
+
+[5.0.0-beta.1]: https://github.com/thoughtbot/bourbon/compare/da4451e...v5.0.0.beta.1
+[2356719]: https://github.com/thoughtbot/bourbon/commit/235671948ef3a9c343c4391d250082a0373c8d83
+[4e43c2d]: https://github.com/thoughtbot/bourbon/commit/4e43c2d7507999b539771bdc1b3733b18b3c1883
+
+## [5.0.0.alpha.0] - 2015-08-21
+
+### Added
+
+- Added a `$global-font-file-formats` setting to globally set the file formats
+  for the `font-face` mixin. The default is `("ttf", "woff2", "woff")`.
+- Add `$consolas`, `$courier-new` and `$monaco` variables (these replace the
+  removed `$monospace` variable).
+
+### Changed
+
+- Removed the type selectors in `$all-text-inputs` and `$all-buttons` to
+  reduce specificity.
+- Font stacks have been modernized. See [3cf106a].
+- The `strip-units` function is now `strip-unit`.
+- The `size` mixin now requires a comma-separated argument list,
+  e.g. `@include size(1em, 2em);`.
+
+### Removed
+
+- All vendor prefixing mixins have been removed. These include:
+  - `align-items`
+  - `animation-delay`
+  - `animation-direction`
+  - `animation-duration`
+  - `animation-fill-mode`
+  - `animation-iteration-count`
+  - `animation-name`
+  - `animation-play-state`
+  - `animation-timing-function`
+  - `animation`
+  - `appearance`
+  - `backface-visibility`
+  - `background-image`
+  - `background`
+  - `border-image`
+  - `calc`
+  - `column-count`
+  - `column-fill`
+  - `column-gap`
+  - `column-rule-color`
+  - `column-rule-style`
+  - `column-rule-width`
+  - `column-rule`
+  - `column-span`
+  - `column-width`
+  - `columns`
+  - `display`
+  - `filter`
+  - `flex-direction`
+  - `flex`
+  - `font-feature-settings`
+  - `hidpi`
+  - `hyphens`
+  - `image-rendering`
+  - `justify-content`
+  - `keyframes`
+  - `linear-gradient`
+  - `perspective`
+  - `placeholder`
+  - `radial-gradient`
+  - `selection`
+  - `text-decoration-color`
+  - `text-decoration-line`
+  - `text-decoration-style`
+  - `text-decoration`
+  - `transform-origin`
+  - `transform-style`
+  - `transform`
+  - `transition-delay`
+  - `transition-duration`
+  - `transition-property`
+  - `transition-timing-function`
+  - `transition`
+  - `user-select`
+  - For prefixing, we recommend using a more robust and maintainable solution
+    like [Autoprefixer].
+- The `$global-prefixes` setting has been removed and the `prefixer` mixin
+  has been refactored and no longer uses it.
+- The `$monospace` variable has been removed.
+- The `box-sizing` mixin has been removed.
+- The `button` mixin has been removed.
+- The `em` and `rem` functions have been removed.
+  - [See the discussion on why these were removed][em-rem-issue].
+- The `flex-grid` function has been removed.
+- The `flex-gutter` function has been removed.
+- The `golden-ratio` function has been removed.
+- The `grid-width` function has been removed.
+- The `inline-block` mixin has been removed.
+- The `retina-image` mixin has been removed.
+- The `triangle` mixin has been removed.
+
+[5.0.0.alpha.0]: https://github.com/thoughtbot/bourbon/compare/v4.3.4...v5.0.0.alpha.0
+[3cf106a]: https://github.com/thoughtbot/bourbon/commit/3cf106a210c1bae7765e6193f62310f95fdee0b7
+[Autoprefixer]: https://github.com/postcss/autoprefixer
+[em-rem-issue]: https://github.com/thoughtbot/bourbon/issues/691
+
+## [4.3.4] - 2017-04-01
+
+### Changed
+
+- Updated deprecation warning message for `strip-units`. ([#1016])
+
+[4.3.4]: https://github.com/thoughtbot/bourbon/compare/v4.3.3...v4.3.4
+[#1016]: https://github.com/thoughtbot/bourbon/pull/1016
+
+## [4.3.3] - 2017-02-23
+
+### Fixed
+
+- Internal Bourbon deprecation warnings for `is-size` and `is-length` will no
+  longer be thrown when using the `size` mixin.
+
+[4.3.3]: https://github.com/thoughtbot/bourbon/compare/v4.3.2...v4.3.3
+
+## [4.3.2] - 2017-02-10
+
+### Fixed
+
+- Internal Bourbon deprecation warnings for `unpack` and `is-length` will no
+  longer be thrown when using the `position` mixin. ([#1004])
+
+[4.3.2]: https://github.com/thoughtbot/bourbon/compare/v4.3.1...v4.3.2
+[#1004]: https://github.com/thoughtbot/bourbon/pull/1004
+
+## [4.3.1] - 2017-02-07
+
+### Fixed
+
+- Internal Bourbon deprecation warnings will no longer be thrown. ([#1002])
+
+[4.3.1]: https://github.com/thoughtbot/bourbon/compare/v4.3.0...v4.3.1
+[#1002]: https://github.com/thoughtbot/bourbon/pull/1002
+
+## [4.3.0] - 2017-02-03
+
+### Added
+
+- Added deprecation warnings for features that will be removed in 5.0.0. Please
+  reference our [change log], which includes a list of these changes and
+  removals. ([#891])
+
+[4.3.0]: https://github.com/thoughtbot/bourbon/compare/v4.2.7...v4.3.0
+[change log]: https://github.com/thoughtbot/bourbon/blob/master/CHANGELOG.md
+[#891]: https://github.com/thoughtbot/bourbon/pull/891
+
+## [4.2.7] - 2016-04-15
+
+### Fixed
+
+- Fixed a Sass deprecation warning when using the `background` and
+  `background-image` mixins.
+
+[4.2.7]: https://github.com/thoughtbot/bourbon/compare/v4.2.6...v4.2.7
+
+## [4.2.6] - 2015-10-17
+
+### Fixed
+
+- Fixed a bug with eyeglass support.
+
+[4.2.6]: https://github.com/thoughtbot/bourbon/compare/v4.2.5...v4.2.6
+
+## [4.2.5] - 2015-09-17
+
+## Added
+
+- Support for [eyeglass].
+
+[4.2.5]: https://github.com/thoughtbot/bourbon/compare/v4.2.4...v4.2.5
+[eyeglass]: http://eyeglass.rocks/
+
+## [4.2.4] - 2015-08-21
+
+## Changed
+
+- [`$all-text-inputs`] now accounts for `input`’s that don’t have a `type`
+  attribute specified, as they default to `type="text"`.
+  (https://github.com/thoughtbot/bourbon/commit/8e7e36e01c47194d83951fb6315c5b26a008f2b7)
+- The [`bourbon` npm package] now has a proper load path.
+  (https://github.com/thoughtbot/bourbon/commit/36c2d5576f1fe9dbdfd9543e15064c5a4a16343e)
+
+[4.2.4]: https://github.com/thoughtbot/bourbon/compare/v4.2.3...v4.2.4
+[`$all-text-inputs`]: http://bourbon.io/docs/#text-inputs
+[`bourbon` npm package]: https://npmjs.com/package/bourbon
+
+## [4.2.3] - 2015-05-18
+
+## Fixed
+
+- Fixed an issue with the `font-face` mixin outputting an extraneous commas when
+  using LibSass set to compressed output.
+
+[4.2.3]: https://github.com/thoughtbot/bourbon/compare/v4.2.2...v4.2.3
+
+## [4.2.2] - 2015-04-01
+
+## Fixed
+
+- The `flex-direction` mixin now properly outputs box-direction (old syntax) if
+  set to normal.
+
+[4.2.2]: https://github.com/thoughtbot/bourbon/compare/v4.2.1...v4.2.2
+
+## [4.2.1] - 2015-02-23
+
+## Fixed
+
+- Restored the `app/` directory for npm.
+
+[4.2.1]: https://github.com/thoughtbot/bourbon/compare/v4.2.0...v4.2.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,6 @@
+# Code of Conduct
+
+By participating in this project, you agree to abide by the
+[thoughtbot code of conduct][tb-coc].
+
+[tb-coc]: https://thoughtbot.com/open-source-code-of-conduct

data/CONTRIBUTING.md

@@ -1,37 +1,90 @@
-We love pull requests from everyone. By participating in this project, you
-agree to abide by the thoughtbot [code of conduct]. Here’s a quick guide:
+# Contributing
 
-[code of conduct]: https://thoughtbot.com/open-source-code-of-conduct
+## Governance
+
+We, the maintainers of Bourbon, would like you to know what to expect when
+interacting with this project's repo.
+
+As a *user* of Bourbon, you can expect care to be put into official releases.
+The maintainers cannot guarantee that the `master` branch will have the same
+API forever.
+
+If you *review pull requests* or *comment on issues*, you are expected to abide
+by our [code of conduct].
+
+As a *contributor*, submitting a pull request or opening an issue, you can
+expect an initial response from a maintainer within two weeks. The maintainers
+cannot guarantee that we will accept all feature requests, and may fix bugs in
+ways other than how the contributor suggests. You are expected to abide by our
+[code of conduct].
+
+As a *maintainer*, you can merge pull requests (even your own) at any time.
+Maintainers are encouraged to request code review from others at thoughtbot or
+any relevant peers. You are expected to abide by our [code of conduct].
+
+Only members of thoughtbot may be maintainers.
 
-1. Fork the repository.
-2. Make your changes in a topic branch.
-3. Squash your commits into a single one (more on that [here](http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html)).
-4. Rebase against `origin/master`, push to your fork and submit a pull request.
-5. If you are writing a new feature please add documentation for it by making another pull request to the `gh-pages` branch.
+## Pull Requests
 
-At this point you’re waiting on us. We like to at least comment on, if not
-accept, pull requests within three business days (and, typically, one business
-day). We may suggest some changes or improvements or alternatives.
+We welcome pull requests from everyone. Here’s a quick guide:
 
-Some things that will increase the chance that your pull request is accepted:
+1. [Fork the repository][fork] and clone to your machine.
+1. Run `bundle install`.
+1. Make sure the tests pass: `bundle exec rake`.
+1. Make your change, following our style guide (below). Write tests. Make sure
+   the tests pass: `bundle exec rake`.
+1. Write a [good commit message][commit]. Push to your fork and
+   [submit a pull request][pr]. If [Hound] catches style violations, fix them.
+1. Wait for us. We try to at least comment on pull requests within one week. We
+   may suggest changes.
 
-* Fix a bug, refactor code or expand an existing feature.
-* Use the right syntax and naming conventions.
-* Update parts of the documentation that are affected by your contribution.
+[fork]: https://github.com/thoughtbot/bourbon/fork
+[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
+[pr]: https://github.com/thoughtbot/bourbon/compare/
+[hound]: https://houndci.com
 
-**Git Commit Messages**
+### Style Guide
 
-* Capitalize your commit messages.
-* Start your message with a verb.
-* Use present tense.
-* Refer to the issue/PR number in your squashed commit message.
+Bourbon uses Sass’s SCSS syntax and aligns to
+[thoughtbot’s style guides][sass guide]. High-level notes:
 
-**SCSS Style Guide**
+- Use two-space indentation (no tabs).
+- Use double quotation marks.
+- Use hyphens when naming things: `hide-visually` rather than `hide_visually` or
+  `hideVisually`.
+- Use one space between property and value: `width: 20px` rather than
+  `width:20px`.
+- Names should be descriptive and aim for clarity over brevity:
+  `$all-text-inputs-hover` rather than `$inputshover` or `$alltxthvr`.
+- Order CSS declarations alphabetically.
+- No trailing whitespace.
 
-* Two spaces, no tabs.
-* Dashes instead of underscores or camel case: `linear-gradient` **not** `linear_gradient` or `linearGradient`
-* Names should be descriptive and written in full-words: `$all-text-inputs-hover` **not** `$hover` or `$alltxthvr`
-* Space between property and value: `width: 20px` **not** `width:20px`
-* Declarations within a block should be ordered alphabetically.
-* Blank lines between rules.
-* No trailing whitespace. Blank lines should not have any space.
+We use [stylelint][stylelint] to lint our CSS and Sass. It's configuration can
+be found in `.stylelintrc.json`. You can run stylelint from the command line via
+`npm run stylelint`, or integrate it with your text editor.
+
+[sass guide]: https://github.com/thoughtbot/guides
+[stylelint]: https://stylelint.io/
+
+### Documentation
+
+We use [SassDoc] to document Bourbon. [Annotations] should be ordered:
+
+- `@link`
+- `@see`
+- `@type`
+- `@argument`
+- `@content`
+- `@property`
+- `@return`
+- `@example`
+- `@require`
+- `@access`
+- `@since`
+- `@author`
+- `@deprecated`
+- `@todo`
+
+[SassDoc]: http://sassdoc.com
+[Annotations]: http://sassdoc.com/annotations
+[code of conduct]: https://thoughtbot.com/open-source-code-of-conduct

data/Gemfile

@@ -1,3 +1,3 @@
-source "http://rubygems.org"
+source "https://rubygems.org"
 
 gemspec