Help:Style guidelines: Difference between revisions

From ActuallyAutistic Wiki
m (→‎Adding references: Added some better formatting)
(Added a disclaimer that makes it clear that the style guidelines are subject to change)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Emphasis|ActuallyAutistic Wiki is very much a work in progress. The following guidelines are therefore subject to change and will likely evolve over time – as is the nature of such collaborative projects!}}
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.
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.


Line 13: Line 14:
== Page titles ==
== 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.
Where possible, page titles should only have their first word capitalised. ''Like this'', but ''Not Like This''.  The exception is if the page is about something that is usually capitalised, such as a book title or a name.


Titles should be singular, not plural, where it makes sense to do so.  For example, "Sense" instead of "Senses".
Page titles should also be ''singular, not plural'', where it makes sense to do so.  For example, ''Sense'' instead of ''Senses''.


== Bold text ==
== Bold and italic 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.
You can make text '''bold''' with
 
<code><nowiki>'''three apostrophes'''</nowiki></code>
 
or ''italic'' with
 
<code><nowiki>''two apostrophes''</nowiki></code>.
 
The more encyclopedic-oriented pages should start off with a brief description or definition of the main subject. Try to incorporate the page title, or relevant parts of it, in a short introductory paragraph, and format the first instance of the main subject as bold text. For example, the page on [[Autism]] could start off with:
<blockquote>
'''Autism''' is a [[Neurodiversity|neurotype]] ...
</blockquote>
 
Throughout a page it would be recommended to use italic text instead of bold text whenever you want to highlight and emphasise a single ''word'' or a ''short passage of text''. This reduces distractability and improves the overall reading flow.


== Sections and subsections ==
== 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''.
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 titled ''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:
A section can be added by typing


=== Example 1 ===
<code><nowiki>== Title of the section ==</nowiki></code>


Just like this.
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 split the section into multiple smaller subsections by using three equal signs:


=== Example 2 ===
<code><nowiki>=== Title of the subsection ===</nowiki></code>


And like this.
It will look like this:


The first few sentences or paragraphs of a page should ''not'' be contained under a section, however.
=== Subsection 1 ===


== Adding references ==
I am a subsection.


To add a reference, type <code><nowiki><ref>TEXT URL</ref></nowiki></code>, where TEXT is just a bunch of plaintext and URL is the link to a website. 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 is an example that leads to the main page https://actuallyautistic.wiki/wiki/Main_Page</ref>
=== Subsection 2 ===


== Meta text and editorial notes ==
I am another subsection.


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 <code>&lt;blockquote&gt;</code> tag, like so:
The first few sentences or paragraphs of a page should ''not'' be contained under a section. Only add sections after the initial few introductory paragraphs.


<nowiki>
Sections and subsections are automatically added to the table of contents at the top of a page. Such a table will be automatically generated should a page contain a large enough number of sections.
  <blockquote style="background-color: pink">
  Needs more citations.
  </blockquote></nowiki>


That will show up on the page something like this:
== References ==


<blockquote style="background-color: pink">
To add a reference, type
Needs more citations.
<blockquote>
<code><nowiki><ref>[http://www.example.com/ An Example Webpage]</ref></nowiki></code>
</blockquote>
</blockquote>
where <code><nowiki>http://www.example.com/</nowiki></code> is a link to a webpage, and <code>An Example Webpage</code> is its title. This will result in a small number superscript where you typed, and the link appearing at the bottom of the page, like this.<ref>[http://www.example.com/ An Example Webpage]</ref>
== Comments ==
Someday we might use the [[Help:Talk pages|wiki's talk pages]], but for now we're having editorial discussions in the pages themselves. Make your comments easy to distinguish from the rest of the text by using
<code><nowiki>{{Comment|Your comment text}}</nowiki></code>
It will then show up like this:
{{Comment|Your comment text}}
Feel free to add four tildes <code><nowiki>~~~~</nowiki></code> at the end of your comment; this will display your username along with a timestamp:
{{Comment|You don't ''have'' to sign your comments though if you'd rather stay anonymous! :)
--[[User:Fochti|Fochti]] ([[User talk:Fochti|talk]]) 12:46, 24 August 2022 (UTC)}}
Please keep in mind that using <code><nowiki>~~~~</nowiki></code> while you're logged out, or if you don't have an account to begin with, ''will publicly display your current IP address instead''.
== Content notes ==
You can add content notes at the top of a page or a section to notify readers about certain things ''before'' they read the actual text.
=== Content warning ===
Sometimes a piece of text or even an entire page can be uncomfortable to read or even triggering for people.
If you type
<code><nowiki>{{Warning}}</nowiki></code>
it will show up as
{{Warning}}
You can also be more specific:
If you type
<code><nowiki>{{Warning|content=Topic1, Topic2}}</nowiki></code>
it will show up as
{{Warning|content=Topic1, Topic2}}
=== Stub pages and sections ===
A ''stub'' is a page or a section of a page that is either very rough and unfinished or even completely empty, serving as a mere placeholder to be filled in later.
If you type
<code><nowiki>{{Stub}}</nowiki></code>
it will show up as
{{Stub}}
=== Redundancy and duplicates ===
Sometimes pages will be created and filled with content that already exists somewhere else.
If you type
<code><nowiki>{{Redundant}}</nowiki></code>
it will show up as
{{Redundant}}
If you type
<code><nowiki>{{Redundant|page=[[Pagename]]}}</nowiki></code>
it will show up as
{{Redundant|page=[[Pagename]]}}


== References ==
== References ==
<references />


[[Category:Meta]]
[[Category:Meta]]

Latest revision as of 20:02, 26 August 2022

ActuallyAutistic Wiki is very much a work in progress. The following guidelines are therefore subject to change and will likely evolve over time – as is the nature of such collaborative projects!

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[edit]

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[edit]

Where possible, page titles should only have their first word capitalised. Like this, but Not Like This. The exception is if the page is about something that is usually capitalised, such as a book title or a name.

Page titles should also be singular, not plural, where it makes sense to do so. For example, Sense instead of Senses.

Bold and italic text[edit]

You can make text bold with

'''three apostrophes'''

or italic with

''two apostrophes''.

The more encyclopedic-oriented pages should start off with a brief description or definition of the main subject. Try to incorporate the page title, or relevant parts of it, in a short introductory paragraph, and format the first instance of the main subject as bold text. For example, the page on Autism could start off with:

Autism is a neurotype ...

Throughout a page it would be recommended to use italic text instead of bold text whenever you want to highlight and emphasise a single word or a short passage of text. This reduces distractability and improves the overall reading flow.

Sections and subsections[edit]

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 titled Sections and subsections.

A section can be added by typing

== Title of the section ==

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 split the section into multiple smaller subsections by using three equal signs:

=== Title of the subsection ===

It will look like this:

Subsection 1[edit]

I am a subsection.

Subsection 2[edit]

I am another subsection.

The first few sentences or paragraphs of a page should not be contained under a section. Only add sections after the initial few introductory paragraphs.

Sections and subsections are automatically added to the table of contents at the top of a page. Such a table will be automatically generated should a page contain a large enough number of sections.

References[edit]

To add a reference, type

<ref>[http://www.example.com/ An Example Webpage]</ref>

where http://www.example.com/ is a link to a webpage, and An Example Webpage is its title. This will result in a small number superscript where you typed, and the link appearing at the bottom of the page, like this.[1]

Comments[edit]

Someday we might use the wiki's talk pages, but for now we're having editorial discussions in the pages themselves. Make your comments easy to distinguish from the rest of the text by using

{{Comment|Your comment text}}

It will then show up like this:

Your comment text

Feel free to add four tildes ~~~~ at the end of your comment; this will display your username along with a timestamp:

You don't have to sign your comments though if you'd rather stay anonymous! :)

--Fochti (talk) 12:46, 24 August 2022 (UTC)

Please keep in mind that using ~~~~ while you're logged out, or if you don't have an account to begin with, will publicly display your current IP address instead.

Content notes[edit]

You can add content notes at the top of a page or a section to notify readers about certain things before they read the actual text.

Content warning[edit]

Sometimes a piece of text or even an entire page can be uncomfortable to read or even triggering for people.

If you type {{Warning}} it will show up as

Content warning: difficult topics. This might get uncomfortable. Remember you always have the option to stop reading if it gets overwhelming.

You can also be more specific:

If you type {{Warning|content=Topic1, Topic2}} it will show up as

Content warning: Topic1, Topic2. This might get uncomfortable. Remember you always have the option to stop reading if it gets overwhelming.

Stub pages and sections[edit]

A stub is a page or a section of a page that is either very rough and unfinished or even completely empty, serving as a mere placeholder to be filled in later.

If you type {{Stub}} it will show up as

This page or section is a stub. Perhaps you can help add something to it? 😊

Redundancy and duplicates[edit]

Sometimes pages will be created and filled with content that already exists somewhere else.

If you type {{Redundant}} it will show up as

This page might be redundant since a similar page already exists. The contents may need to be merged.

If you type {{Redundant|page=[[Pagename]]}} it will show up as

This page might be redundant since Pagename already exists. The contents may need to be merged.

References[edit]