Style Guide

This style guide describes how to consistently format pages on the CTO Website.

Generally, we start with the U.S. Web Design Standards (USWDS) components and derive our default styles from there. We strive to make use of the USWDS components first and foremost, using custom components only when the USWDS components will not meet our needs.

Headings

The first-level (aka main) heading on a page is a H1. This should be the page's title and is usually the first thing users see at the top of a page.

If you are writing a page in HTML:

<div class="usa-grid">
  <h1>Projects</h1>

  ... page content here ...
</div>

If you are writing a page in Markdown:

# Projects

... page content here ...

If you are writing a CTO Guide: Don't use first-level (# or H1) or second-level (## or H2) headings while writing your guide. Only use third-level (### or H3) and onwards. The guide template will automatically set the first-level heading to "Guides", and the second-level heading will automatically be the title of your guide.