Getting Started

This site includes documentation of the tools, components, and styles used on OddSite. There are also sample pages available for viewing aspects of the site in context – including typography, colors, responsive images, and more.

Writing Content

When creating content, it is important to stay consistent. Here are some guidelines to help:

Branding

• Always capitalize the “O”, “B”, and “S” in OddBird and OddSite.

Commas

• Use the Oxford comma: “writing, design, and development” Note the final comma before and.

Dashes

• En Dash – Used to show ranges of things (e.g. “January–March”)
• Em Dash — Instead of using em-dashes for asides (as suggested by the The Chicago Manual of Style), using <space><en-dash><space> makes the block of text more readable (e.g. “this thing – and also that thing – etc”). Read more here.
• Citations still need 2-3 dashes (-) to trigger the attribution class.

Headlines

• Use Title Case: Capitalize the first letter of every word except articles, prepositions, and conjunctions.
• Do not use punctuation at the end of your title unless it contains more than one sentence, is a question, or would benefit from an interrobang (highly encouraged)‽

Tags

• In general, blog posts should include the tag Article
• Reference the tag list to avoid variations of a tag.
• Tags are Title Case: User Experience
• Tags with multiple words should have spaces instead of dashes unless the phrase is hyphenated (e.g. Server-Side Rendering).
• We have 5 Post Types which use the same tag structure but we have promoted on the Posts by Tag (high placement and icon in heading) and Posts by Date (icon displayed) pages. These include:
  • Article
  • Case Study
  • Link
  • Podcast
  • Video

Case Study posts include tags for their industry, for example Technology Sector

Image Organization

Type of Content	Source Image Folder
OddBird Heros	birds
Blog	blog
Static Pages	pages
Open Source	projects
Testimonials	quotes
Susy	susy
Talks	talks
Work	work/projectname
Books	writing

There are a few additional image folders for specific use cases.