Keep the file structure consistent for different file types

One tag per article

Refer to the list of tags for documentation articles in application_helper.rb

Find the list of tags for blog posts on the blog post page.

Excerpt

Each article should start with motivational text at the top. The excerpt should summarise what the article is about, and what the reader will learn. Do not put a full stop at the end of the excerpt.

Headings

The title of every article uses an h1 heading; article sections use h2 headings; subsections use h3 headings; etc.

Headings are favoured by our search engine, Algolia. Think about how users will search for the topic and include those phrases in the headings in particular.

When writing headings, capitalise the first word only.

Helpers

Use the translations in locale.yml and helpers in helpers/application_helper.rb wherever possible for consistency and easy maintenance, and feel free to add more