diff --git a/.gitignore b/.gitignore
index 65ec875b..94a0fe7a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,14 +1,15 @@
*.log
*.tgz
.DS_Store
-.changelog
+.cache/
+.changelog/
.next/
.sass-cache
-.stylelintcache
.storybuild/
+.stylelintcache
_site
dist/
+docs/dist
node_modules/
-searchIndex.js
-.cache/
public/
+searchIndex.js
diff --git a/.nowignore b/.nowignore
new file mode 100644
index 00000000..a6df94c6
--- /dev/null
+++ b/.nowignore
@@ -0,0 +1,5 @@
+.*.sw?
+.changelog/
+dist/
+docs/dist
+docs/public/
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 02811610..d10a4294 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,26 +1,46 @@
+### :rocket: Enhancements
+- [#994](https://github.com/primer/css/pull/994) Responsive line-height utilities
+- [#995](https://github.com/primer/css/pull/995) Add bold weight to marketing font variables
+
+### :bug: Bug fixes
+- [#998](https://github.com/primer/css/pull/998) Use a gray background when hovering SelectMenu items
+
+### :memo: Documentation
+- [#989](https://github.com/primer/css/pull/989) Add link to the Stylelint guide
+- [#1000](https://github.com/primer/css/pull/1000) Update contributing guide for a general audience
+- [#972](https://github.com/primer/css/pull/972) Variables page
+
+### :house: Internal
+- [#997](https://github.com/primer/css/pull/997) Fix CHANGELOG links
+
+### Committers
+- [@shawnbot](https://github.com/shawnbot)
+- [@simurai](https://github.com/simurai)
+- [@skullface](https://github.com/skullface)
+
## 14.0.0
### :boom: Breaking changes
-- [#922](https://github.com/primer/css/922) More SelectMenu improvements
-- [#966](https://github.com/primer/css/966) Rename `.flex-item-equal` to `.flex-1`
-- [#973](https://github.com/primer/css/973) Deprecate variables in 14.0.0
+- [#922](https://github.com/primer/css/pull/922) More SelectMenu improvements
+- [#966](https://github.com/primer/css/pull/966) Rename `.flex-item-equal` to `.flex-1`
+- [#973](https://github.com/primer/css/pull/973) Deprecate variables in 14.0.0
### :rocket: Enhancements
-- [#987](https://github.com/primer/css/987) Add .position-sticky utility
-- [#979](https://github.com/primer/css/979) Add `.radio-group` component
-- [#981](https://github.com/primer/css/981) Autocomplete + Suggester components
-- [#978](https://github.com/primer/css/978) Add `.css-truncate-overflow`
-- [#974](https://github.com/primer/css/974) Add Animated Ellipsis
-- [#971](https://github.com/primer/css/971) Add variable deprecation data and tests
+- [#987](https://github.com/primer/css/pull/987) Add .position-sticky utility
+- [#979](https://github.com/primer/css/pull/979) Add `.radio-group` component
+- [#981](https://github.com/primer/css/pull/981) Autocomplete + Suggester components
+- [#978](https://github.com/primer/css/pull/978) Add `.css-truncate-overflow`
+- [#974](https://github.com/primer/css/pull/974) Add Animated Ellipsis
+- [#971](https://github.com/primer/css/pull/971) Add variable deprecation data and tests
### :memo: Documentation
-- [#988](https://github.com/primer/css/988) Add docs for flexbug no. 9
-- [#977](https://github.com/primer/css/977) Update spacing.md
+- [#988](https://github.com/primer/css/pull/988) Add docs for flexbug no. 9
+- [#977](https://github.com/primer/css/pull/977) Update spacing.md
### :house: Internal
-- [#952](https://github.com/primer/css/952) Async/awaitify script/dist.js
-- [#963](https://github.com/primer/css/963) Generate changelog with semantic-release
-- [#968](https://github.com/primer/css/968) Stylelint update
+- [#952](https://github.com/primer/css/pull/952) Async/awaitify script/dist.js
+- [#963](https://github.com/primer/css/pull/963) Generate changelog with semantic-release
+- [#968](https://github.com/primer/css/pull/968) Stylelint update
### Committers
- [@BinaryMuse](https://github.com/BinaryMuse)
@@ -31,20 +51,20 @@
# 13.2.0
### :rocket: Enhancements
-- [#959](https://github.com/primer/css/959) More buttons
-- [#950](https://github.com/primer/css/950) Add Diffstat component
-- [#913](https://github.com/primer/css/913) Importing TimelineItem from .com and creating matching docs
-- [#953](https://github.com/primer/css/953) Add IssueLabel component
+- [#959](https://github.com/primer/css/pull/959) More buttons
+- [#950](https://github.com/primer/css/pull/950) Add Diffstat component
+- [#913](https://github.com/primer/css/pull/913) Importing TimelineItem from .com and creating matching docs
+- [#953](https://github.com/primer/css/pull/953) Add IssueLabel component
### :bug: Bug fixes
-- [#945](https://github.com/primer/css/945) Add `[role=tab][aria-selected=true]` to `.UnderlineNav-item.selected`
+- [#945](https://github.com/primer/css/pull/945) Add `[role=tab][aria-selected=true]` to `.UnderlineNav-item.selected`
### :memo: Documentation
-- [#939](https://github.com/primer/css/939) Fix `Box--overlay` example
-- [#943](https://github.com/primer/css/943) Fix broken links to typography utilities
+- [#939](https://github.com/primer/css/pull/939) Fix `Box--overlay` example
+- [#943](https://github.com/primer/css/pull/943) Fix broken links to typography utilities
### :house: Internal
-- [#946](https://github.com/primer/css/946) Add `TODO@version` stylelint rule (local)
+- [#946](https://github.com/primer/css/pull/946) Add `TODO@version` stylelint rule (local)
### Committers
- [@MohamedElidrissi](https://github.com/MohamedElidrissi)
diff --git a/docs/.eslintrc.json b/docs/.eslintrc.json
index cb1a8800..b9893185 100644
--- a/docs/.eslintrc.json
+++ b/docs/.eslintrc.json
@@ -13,5 +13,8 @@
"react": {
"version": "detect"
}
+ },
+ "globals": {
+ "__DEV__": "readonly"
}
}
diff --git a/docs/content/components/select-menu.md b/docs/content/components/select-menu.md
index ec62e99d..a033a9a7 100644
--- a/docs/content/components/select-menu.md
+++ b/docs/content/components/select-menu.md
@@ -254,12 +254,48 @@ The Select Menu's list can be divided into multiple parts by adding a `.SelectMe
```
-## Additional filter and footer
+## Footer
+
+Use a `.SelectMenu-footer` at the bottom for additional information. As a side effect it can greatly improve the scrolling performance because the list doesn't need to be repainted due to the rounded corners.
+
+```html live
+
+
+ Choose an item
+
+
+
+
+
Title
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+## Filter
If the list is expected to get long, consider adding a `.SelectMenu-filter` input. Be sure to also include the `.SelectMenu--hasFilter` modifier class. On mobile devices it will add a fixed height and anchor the Select Menu to the top of the screen. This makes sure the filter input stays at the same position while typing.
-Also consider adding a `.SelectMenu-footer` at the bottom. It can be used for additional information, but can also greatly improve the scrolling performance because the list doesn't need to be repainted due to the rounded corners.
-
```html live
diff --git a/docs/content/getting-started/contributing.md b/docs/content/getting-started/contributing.md
index ece93dc4..cdd720da 100644
--- a/docs/content/getting-started/contributing.md
+++ b/docs/content/getting-started/contributing.md
@@ -3,13 +3,15 @@ title: Contributing
description: Guidelines for contributing to GitHub's CSS
---
+While this contributing guide is for GitHub employees, all contributions from the community are welcome.
+
## Decision process for adding new styles
### Components
[Components](/css/components) are frequently used visual patterns we've abstracted into a set of convenient styles, that would be otherwise difficult to achieve with utilities and layout objects.
-Making a decision on whether new components should be added is done on a case by case basis. It's not always easy to make that decision but here are some questions you should ask yourself before moving forward with a pull request. The design systems team will help you make this decision.
+Decisions to add new components are made on a case-by-case basis, with help from the GitHub Design Systems team. Some questions that we use to guide these decisions include:
- How often is this pattern used across the site?
- Could these styles be achieved with existing components, objects, and utilities?
@@ -39,7 +41,7 @@ Many of the same questions can be applied to objects and utilities, however the
It's usually better to open an issue before investing time in spiking out a new pattern. This gives the design systems team a heads up and allows other designers to share thoughts. Here's an outline of what's helpful to include in a new style issue:
-1. What the pattern is and how it's being used across the site - post screenshots and urls where possible. If you need help identifying where the pattern is being used, call that out here and cc the relevant team and/or cc `@product-design` to help.
+1. What the pattern is, and how it's being used on GitHub.com. Post screenshots and/or URLs whenever possible. If you need help identifying where the pattern is used, call that out in the issue.
2. Why you think a new pattern is needed (this should answer the relevant questions above).
3. If you intend to work on these new styles yourself, let us know what your timeline and next steps are. If you need help and this is a dependency for shipping another project, please make that clear here and what the timeline is.
4. Add the appropriate label(s):
@@ -66,7 +68,7 @@ New styles we add should be used in as many places as makes sense to in producti
If you get to this step you've helped contribute to a style guide that many of your colleagues use on a daily basis, you've contributed to an open source project that's referenced and used by many others, and you've helped improve the usability and consistency of GitHub for our users. Thank you!
-Let the [design systems team](https://github.com/github/design-systems) know if we can improve these guidelines and make following this process any easier.
+[Please open an issue](#step-1-open-an-issue) if we can improve these guidelines and make following this process any easier.
## Removing styles and variables
@@ -161,7 +163,7 @@ Check out Doctocat's [live code](https://primer.style/doctocat/usage/live-code)
Primer CSS follows [semantic versioning](http://semver.org/) conventions. This helps others know when a change is a patch, minor, or breaking change.
-To understand what choice to make, you'll need to understand semver and know if one of the changes shown is a major, minor, or patch. Semver is confusing at first, so I recommend reviewing [semver](http://semver.org/) and/or ask in [#design-systems](https://github.slack.com/archives/design-systems) or and experienced open-source contributor.
+To understand what choice to make, you'll need to understand semver and know if one of the changes shown is a major, minor, or patch. Semver is confusing at first, so we recommend reviewing [semver](http://semver.org/) and/or asking the team by [opening an issue](#step-1-open-an-issue).
[semantic versioning]: https://semver.org
[script/test-deprecations.js]: https://github.com/primer/css/tree/master/script/test-deprecations.js
diff --git a/docs/content/support/variables.mdx b/docs/content/support/variables.mdx
new file mode 100644
index 00000000..6c4f97cc
--- /dev/null
+++ b/docs/content/support/variables.mdx
@@ -0,0 +1,16 @@
+---
+title: Variables
+path: support/variables
+status: Experimental
+bundle: alerts
+---
+
+import {Variables, DeprecationIcon} from '../../src/variables'
+
+
+
+The tables below list all of the global SCSS variables defined in [the `support/variables` directory](https://github.com/primer/css/tree/master/src/support/variables).
+
+Variables with a are planned for [deprecation](../tools/deprecations) in a future version of `@primer/css`, and should be avoided.
+
+
diff --git a/docs/content/tools/linting.md b/docs/content/tools/linting.md
index 678b083e..39e36ee4 100644
--- a/docs/content/tools/linting.md
+++ b/docs/content/tools/linting.md
@@ -103,3 +103,7 @@ We test for the proper use of the [Octicons helper](https://github.com/primer/oc
## IE rule limit
We check that our compiled CSS assets don't contain more selectors than the [IE CSS selector limits](https://blogs.msdn.microsoft.com/ieinternals/2011/05/14/stylesheet-limits-in-internet-explorer/).
+
+## Linting dotcom
+
+There are a few handy scripts to make your life easier when working with CSS on dotcom, especially when doing bigger refactors. Checkout the [Stylelint guide](https://github.com/github/design-systems/blob/master/tools/stylelint.md).
diff --git a/docs/content/utilities/typography.md b/docs/content/utilities/typography.md
index 1a7deff8..2844cd03 100644
--- a/docs/content/utilities/typography.md
+++ b/docs/content/utilities/typography.md
@@ -8,7 +8,7 @@ bundle: utilities
Type utilities are designed to work in combination with line-height utilities so as to result in more sensible numbers wherever possible. These also exist as [variables](/css/support/typography#typography-variables) that you can use in components or custom CSS.
-
+
Font sizes are smaller on mobile and scale up at the `md` [breakpoint](/css/support/breakpoints) to be larger on desktop.
@@ -67,7 +67,8 @@ Lighter font-weight utilities are available in a limited range. Lighter font-wei
```
## Line height styles
-Change the line height density with these utilities.
+
+Change the line height density with these utilities. Responsive variants are also available (e.g. `.lh-sm-condensed`).
```html live