Guide:Contributor's Guide

This article is for new contributor's to learn how to edit the wiki.

Temporary Contributor's Guide
This section is temporary!

For the mean time, whilst we are setting up the wiki, and still working out proper etiquette and formatting, here are some things to keep in mind when you contribute:


 * Please join the Matrix or Discord chat
 * Wiki discussions happen in this chat (Recommended chat)
 * Matrix space: here
 * Discord: here (Linked to main Subreddit chat, will be linked to Wiki chat if enough people won't use Matrix)
 * Formatting subject to change
 * As the formatting and etiquette is worked out, your page may move location, be rewritten, or completely reformatted. Nothing personal, will mainly be for consistency.
 * This wiki has a focus on beginners
 * Before we do work on more advanced things that can be done with Linux, we want to focus on on-boarding new Linux users from the Steam Deck
 * Try to use wordings a beginner would understand
 * Linux-centric words should be followed by an explanation in brackets, for the first appearance on page. For example: "one key is the Meta key (Windows key)"
 * Always think: would a beginner understand this? If you could even get a beginner to proof read that would be awesome, but not necessary.
 * Refer to the OS as SteamOS, and the PC as the Steam Deck. Guides for other distros are not a priority for now, and a beginner won't get what Arch / Plasma is.
 * Some formatting tips:
 * Screenshots are awesome
 * Screenshots of the desktop should use Plasma. If you don't use Plasma, ask in the Matrix chat for someone to make you a particular screenshot
 * When SteamOS 3 is released, many screenshots may have to be retaken
 * Add the WIP template to any unfinished Pages / Guides
 * A howto / guide should be under the Guide: namespace
 * An informational page should be under the default namespace

If you need any help / have any questions, reach out in the matrix, or contact Moxvallix at @moxvallix:matrix.org or u/Moxvallix on Reddit.

Opening the Editor
MediaWiki allows for quick and easy editing of pages on the wiki. To edit a page, click the edit button located at the top right of the page, or click the pencil icon to the right of the particular section you would like to edit. Clicking on the pencil icon that has a small eye next to it allows you to use the visual editor.

Using the Visual Editor
Most of the editing you will do will be inside the Visual Editor. The Visual Editor is fairly straightforward; there is an area for text editing, and a formatting bar at the top left of the page. This bar contains the following (icons, from left to right):


 * 1) Undo: Undoes last change
 * 2) Redo: Redoes last undone change
 * 3) Text Formatting Dropdown: Sets a text format (eg. Subheader 1)
 * 4) Font Style Dropdown:  Sets a font style (eg. Bold)
 * 5) Link: Adds a link to the page
 * 6) Cite: Adds a citation
 * 7) Lists: Sets the list type (eg. Bullet list)
 * 8) Insert Dropdown: Insert templates, tables and media
 * 9) Special Character: Insert special character

Keeping a Consistent Style
When editing a page, look to the style of the rest of the page, and try to keep any content you add consistent with this style. See the Etiquette page for more information.

Creating a New Page
To create a new page, either create a blank link from an existing page, or search for the new page in the search box and click Create.