Visitar URL original
USWDS - Documentation: Fix 18F guide links by manichandra · Pull Request #6658 · uswds/uswds · GitHub
Skip to content

USWDS - Documentation: Fix 18F guide links #6658

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
annepetersen merged 2 commits into from
May 20, 2026
Merged

USWDS - Documentation: Fix 18F guide links #6658

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d784dba
USWDS - Documentation: Fix 18F guide links
manichandra May 19, 2026
f3075ac
Merge branch 'develop' into codex/uswds-6543-18f-links
msbtterswrth May 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -491,8 +491,8 @@ The values of `$theme-font-path` and `$theme-image-path` will be appended to USW
## CSS architecture

- The CSS foundation of this site is built with the **[Sass](https://sass-lang.com)** preprocessor language.
- The CSS organization and naming conventions follow **[18F’s Engineering Guide](https://guides.18f.gov/engineering/languages-runtimes/css/#naming)**.
- We format our code with [Prettier](https://prettier.io/), per the formatting section of the **[18F Engineering Guide](https://guides.18f.gov/engineering/languages-runtimes/css/#formatting)**.
- The CSS organization and naming conventions follow **[18F’s Engineering Guide](https://guides.18f.org/engineering/languages-runtimes/css/#naming)**.
- We format our code with [Prettier](https://prettier.io/), per the formatting section of the **[18F Engineering Guide](https://guides.18f.org/engineering/languages-runtimes/css/#formatting)**.
- CSS selectors are **prefixed** with `usa` (For example: `.usa-button`). This identifier helps the design system avoid conflicts with other styles on a site which are not part of USWDS.
- Uses a **[BEM](http://getbem.com/)** approach for naming CSS selectors. Blocks are separated from elements with two underscores (`__`). Multi-word blocks use single hyphens instead of spaces. Modifier classes are additive — proper markup requires the base class _and_ the modifier class or classes. Modifier classes consist of the base class plus a modifier suffix, separated by two hyphens (`--`) as in `.usa-button.usa-button--secondary` or `usa-accordion.usa-accordion--bordered`.
- Uses **modular CSS** for scalable, modular, and flexible code.
Expand All @@ -502,7 +502,7 @@ The values of `$theme-font-path` and `$theme-image-path` will be appended to USW
- **Spacing units** are set with the `units()` function as described in [the USWDS 3.0 documentation](https://designsystem.digital.gov/design-tokens/spacing-units/). In general, we use spacing in multiples of `8px` — expressed as a multiple in `units([multiple])`. For instance `units(2)` is the equivalent of `2 * 8px` or `16px`. In the final, compiled CSS, this value will be expressed in rem, as a multiple of the base font size set with `$theme-base-font-size`.

**For more information, visit:**
[18F’s CSS Guide](https://guides.18f.gov/engineering/languages-runtimes/css/)
[18F’s CSS Guide](https://guides.18f.org/engineering/languages-runtimes/css/)

## Browser support

Expand Down