Basic page style guide

_Français

Scheduled transition page - 2024 09 13

Text component

This is the main content of your page and the most commonly used component on your website.

Writing for the web guidelines  H3

Here are a few writing guidelines to make your web page more readable

Write to a reading grade level of 8 or lower whenever possible  H4

This makes your website accessible to a wider range of users and allows the content to be understood by almost all, with links included

Tips for writing at lower reading grades:  H5

• break apart sentences when possible, and keep them short
• avoid jargon, complex words and phrases. Consider adding a glossary for terms your readers may not know
• use headings and bullet points to break up your content into smaller chunks
• Expand acronyms on first use. For example, Web Content Accessibility Guidelines (WCAG)
• use images, illustrations, video and audio to help clarify meaning

Header size H6

Horizontal Rules

And spacing around them

Document links in Body component 

Copy the URL from the media page and insert link into highlighted text.

Documents in text using /sites/default/files/2026-01/PD-170-1bInclusiveEdinABSchools-ResearchReport.pdf

Documents in text using https://teachers.ab.ca/sites/default/files/2026-01/PD-170-1bInclusiveEdinABSchools-ResearchReport.pdf

Table styles

Style 2

Column head

Column head 2

Use sentence case

Studies have found that it's easier for users to scan content when it is in sentence case as it allows the eye to flow better. By writing in sentence case you are actually helping your users find what they are looking for more quickly. 

Use headings to convey meaning and structure

Use short headings to group related paragraphs and to describe the sections. This provides an easier flow of reading and understanding the content for the user. Heading1 (H1) is only used for page titles and should not be used within the content. Use Heading2 (H2) to break content into smaller, more specific sections. Heading3 (h3) is used as a subheading of H2 (do not skip heading levels e.g. Heading4 (H4) should not be nestled directly under H2). It also breaks it down into smaller sections which is less overwhelming than a wall of text. It provides organization as it helps users find specific content that they might be looking for in a page.

Use lists (bullets, numbers) for groups of related items

Use numbered lists to list steps in a process. Use bulleted lists for lists of links or other information.

Here's a list example

• item one
• item two

Here's a numbered example

1. first item
2. second item
3. third item
4. fourth item
5. fifth item
6. sixth item
7. seventh item
8. eighth item
9. ninth item
10. tenth item - The Alberta Teachers’ Association, as the professional organization of teachers, promotes and advances public education, supports teachers' professional practice and serves as the advocate for its 46,000 members.