Style guide

These are the house editorial standards.

Some are more aspirational than others.

Prose

Posts should be titled in sentence case.

For example: A beautiful day for a ride
Err on the side of longer quotes in <blockquote> elements over shorter quotes in quotation marks, but don’t overdo it.
When quoting, any omissions must be marked with bracketed elipses, and any changes must be surrounded with brackets.

For example: I heard him say, “[Inspector Gadget] will never […] take me alive!”
When quoting, prefer to emphasize text with highlighting. Highlights do not need to be disclaimed.
Other forms of emphasis, like bolding or italicising quoted text, should be disclaimed. Noting when emphasis was present in the original is not required, but may be useful for the reader.
Do not omit an article when referencing Apple products.

For example: Steve Jobs debuted the iPhone.

Link text should be descriptive. The description might be a single word or a whole phrase, and is not restricted to nouns.

For example: I was interviewed by ZSA.

Alternative: I was interviewed by ZSA.

For example: To get notified when I publish a new post, subscribe to the blog.

AKA “Make the Thing a Link”.
Links to PDFs should usually end with (PDF). (In the future, it would be nice to handle this with CSS.)

For example: Apple Style Guide (PDF)
Cool URIs don’t change. Strive to be as cool as possible.

Never place punctuation inside quotation marks unless it was part of the quoted source.

For example: It begins with the phrase “Four score and seven years ago”.

Never: ~~It begins with the phrase “Four score and seven years ago."~~
An em-dash should always be surrounded by spaces. This way, words on each side of the dash are not falsely connected.

For example: But — you exclaim — no one does it that way!

It also makes for much better markdown editing for Git, where each section before / between / after the dashes can be placed on its own line.
Commas should be inserted in the Oxford style.

Post dates should be written in Cistercian numerals.

For example: 􀀂􀀟􀀍􀀅 􀀂􀀞􀀖􀀎􀀃 A Christmas Day post

(Note that the Cistercian date cannot be bold, because WebKit doesn’t render that font propertly in bold.)
Dates in prose should be written as YYYY-MM-DD.

For example: I was home for Christmas on 2023-12-31 .
Time should always be specified in 24-hour format.

For example: I woke up at 08:00.

For example: I went to bed at 23:00.

Unix commands should be displayed in monospace and with their manual section, like git(1).
Thou shalt not suffer a bashism to live. When writing shell scripts, do not rely on GNU (or other) extensions. (See also.)

Sometimes helpful to see what others are doing, even if only to know what not to do.