Skip to content
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

ODI style guide updates #79

Merged
merged 8 commits into from
Jun 12, 2024
Merged

ODI style guide updates #79

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
035e174
Update odi-style-guide.md
m-sullivan7 Jun 10, 2024
b14596e
Update odi-style-guide.md
m-sullivan7 Jun 10, 2024
2dfe2cc
Update odi-style-guide.md
m-sullivan7 Jun 10, 2024
a14513f
Update odi-style-guide.md
m-sullivan7 Jun 11, 2024
e778f7b
Update odi-style-guide.md
m-sullivan7 Jun 11, 2024
d238a82
Update odi-style-guide.md
m-sullivan7 Jun 11, 2024
f80a29f
Update odi-style-guide.md
m-sullivan7 Jun 12, 2024
91e3e26
Update odi-style-guide.md
m-sullivan7 Jun 12, 2024
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
28 changes: 28 additions & 0 deletions docs/pages/content-design/odi-style-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,34 @@ To make your headings effective:
* Don’t skip heading levels. For example, don’t go straight from H2 to H4. Each level has its own style. Using levels consistently makes a good experience for readers. This also helps people using screen readers.
* Nest heading levels appropriately. For example, H3s can be used for content relevant to the H2 above it. But don’t go past H4. That much nesting is hard for readers to follow.

### Law citations

When referencing a law, use this format: Chamber Bill number (author’s political party affiliation abbreviation, author last name-author’s city), bill title.

If you’re unsure of the author’s city, use [CalMatters’ legislators directory](https://digitaldemocracy.calmatters.org/legislators). Use [California Legislative Information](https://leginfo.legislature.ca.gov/faces/home.xhtml) to find the bill title.

If you mention a bill from that chamber later in your text, put the abbreviation **AB** or **SB** in parentheses after the first use. Follow our [acronym rules](https://hub.innovation.ca.gov/content-design/odi-style-guide/#acronyms).

<div class="blockquote-container">
<div class="blockquote-body">
<div class="blockquote-header"><strong>Example:</strong></div>
<div class="blockquote-content">
Senate Bill (SB) 35 (D, Weiner-San Francisco), Planning and zoning: affordable housing: streamlined approval process passed in 2017. SB 35 aims to build more affordable housing faster.
</div>
</div>
</div>

If citing a law in a list of references, use this format: Title, chamber abbreviation-number, California Legislature, legislative body, year. LegInfo URL

<div class="blockquote-container">
<div class="blockquote-body">
<div class="blockquote-header"><strong>Example:</strong></div>
<div class="blockquote-content">
Planning and zoning: affordable housing: streamlined approval process, SB 35, California Legislature, Senate (2017). https://leginfo.legislature.ca.gov/faces/billNavClient.xhtml?bill_id=201720180SB35
</div>
</div>
</div>

### Links

Links are embedded in text instead of standing alone.
Expand Down
Loading