Having consistency across pages improves user experience and makes Arbital pages feel more polished. This page lists guidelines to follow when writing a page's title, clickbait, summary, and body text.
If there are any stylistic considerations you'd like clarified, comment here.
For style guidelines that apply specifically to the math domain, see Math style guidelines.
Yes: US spelling and terminology %%note: One day we'll have localization.%%.
Yes: "First letter is capital"
Yes: "Is it okay for the title to be a question?"
Yes: "Short and sweet"
No: "Capitalize Every Word"
No: "Period at the end."
No: "This is a long title that's basically a complete sentence of its own" (Use clickbait for that)
- Exceptions: asking a question or evaluating a proposition
Yes: "First letter is capital."
Yes: "Pique user's interest in the topic."
Yes: "Most clickbaits are just one sentence telling user what they might find out if they read the page."
Yes: "Can a clickbait ask the reader a leading question?"
Yes: "Period or other punctuation at the end."
Yes: Omitting clickbait if the title is descriptive enough.
No: "Capitalize Every Word"
- Yes: "lowercasewithunderscores"
- Yes: "usingfullwords"
- Yes: "bespecificstyle_guide" (as opposed to "specific")
- No: "abrv" (abbreviations)
- No: "MUAs" (made up acronyms)
- No: "aliasthatisclearlywaytoolongtobeusefulor_memorable"
- If the alias has alternate meanings, e.g. "element", append the relevant domain's name, e.g. "elementmathematics" (or, for arbital domain pages, prepend e.g. "arbitalstyle_guideline").
- Prefer single ("penguin") to plural version ("penguins"), if possible.
Yes: Put it at the top of the page
Yes: Not having a summary if the first paragraph is already a good summary. Yes: "Paragraph long explanation summarizing the contents of the page…"
Yes: "Using Markdown as normal."
[comment: Yes: "If the page has a vote, describe exactly what the vote is about."]
Yes: Conversational, fun tone.
Yes: We as a personal pronoun.
Yes: Explaining things in whatever way works best.
No: I as a personal pronoun.
Most Arbital pages are between one to five screens long. They are usually much shorter than Wikipedia pages. It's probably best to break very long pages into a few shorter pages, especially if they need to be used as requisites.
Yes: Using a
[link] when a concept is introduced or mentioned within a section.
Yes: Using a [ red link] when you want to indicate that there should be a page for that concept (with or without a title, i.e.
[page\_title display text] vs
[ display text]).
Yes: Link glossary pages for overloaded words.
No: "Using the
[same link] in very close proximity to the
No: Specifying the title of the page exactly:
<a href="arbital_style_guide.html">Style guidelines</a>, instead just do
<a href="arbital_style_guide.html">Style guidelines</a>
Yes: Capitalize first letter and no period at the end
No: Header for the opening section
No: "Period or other punctuation at the end."