One tag per article
Refer to the list of tags for documentation articles in
Find the list of tags for blog posts on the blog post page.
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.
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.
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