Help:Style guidelines: Difference between revisions
m (→Adding references: Added some better formatting) |
(→Adding references: Formatting; added some clarification) |
||
Line 39: | Line 39: | ||
== Adding references == | == Adding references == | ||
To add a reference, type <code><nowiki><ref>TEXT URL</ref></nowiki></code> | To add a reference, type | ||
<blockquote> | |||
<code><nowiki><ref>TEXT [URL LINKTEXT]</ref></nowiki></code> | |||
</blockquote> | |||
where TEXT is just a bunch of plaintext, URL is the link to a website, and LINKTEXT is the shortened version of that URL. This will result in a small number superscript where you typed, and the words followed by the URL at the bottom of the page, like this<ref>This link leads to the main page: [https://actuallyautistic.wiki/wiki/Main_Page Click me!]</ref>. | |||
== Meta text and editorial notes == | == Meta text and editorial notes == |
Revision as of 00:05, 24 August 2022
To maintain a cohesive wiki, please stick to the style guidelines where possible. Though don't let that put you off — feel free to just add and edit articles as you like, and other people will likely tidy up the formatting later on.
This guide will you a brief overview of the formatting options available. If you want to know more about how linking pages to other pages works, this guide has all the info.
Point of view
We especially encourage articles informed by lived experience, and recognise that "objectivity" doesn't mean reinforcing the outgroup's status quo.
It's also safe to assume the reader is autistic, although they may only recently have discovered this fact. They may not yet know all the terminology, but they're happy to follow the links to learn more. This wiki is primarily by autistic people, for autistic people, although others are welcome to contribute.
We especially encourage a neurodiversity-affirming approach that suggests all neurotypes are equally valid, while simultaneously acknowledging that being neurodivergent in a neuro-typical society can be disabling.
Page titles
Where possible, page titles should only have their first word capitalised. "Like this", "Not Like This". The exception is if the page is about something that is usually capitalised, such as a book.
Titles should be singular, not plural, where it makes sense to do so. For example, "Sense" instead of "Senses".
Bold text
Try to incorporate the page title, or relevant parts of it, into the first sentence or paragraph and format the first instance of it as bold text. If the page title is "Autism", the first instance of the word "Autism" should be formatted as Autism, for example.
Sections and subsections
For longer pages it is often a good idea to use multiple sections to separate the text into different, visually distinct parts. It improves both readability as well as skimmability. You're currently reading the section Sections and subsections.
If you get the feeling that a single section might contain too much text, try thinking about moving parts of it to another new section entirely, or splitting the section into multiple smaller subsections:
Example 1
Just like this.
Example 2
And like this.
The first few sentences or paragraphs of a page should not be contained under a section, however.
Adding references
To add a reference, type
<ref>TEXT [URL LINKTEXT]</ref>
where TEXT is just a bunch of plaintext, URL is the link to a website, and LINKTEXT is the shortened version of that URL. This will result in a small number superscript where you typed, and the words followed by the URL at the bottom of the page, like this[1].
Meta text and editorial notes
Someday we might use the wikimedia Talk page, but for now we're having editorial discussions in the page itself. Make them easy to see by setting them off in a pink box. Wrap your note in a styled <blockquote>
tag, like so:
<blockquote style="background-color: pink"> Needs more citations. </blockquote>
That will show up on the page something like this:
Needs more citations.