View source for SASGamingWiki:Editing guide

__NOTOC__
<div style="width:100%; background:linear-gradient(135deg, #1E3A8A 0%, #6B21A8 50%, #5865F2 100%); border-radius:12px; padding:32px 24px; text-align:center; margin-bottom:24px;">
<span style="font-size:2em; font-weight:bold; color:#ffffff; display:block; margin-bottom:8px;">Editing Guide</span>
<span style="font-size:1.1em; color:#d1d5db;">How to contribute, edit pages, and work with upstream synced content</span>
</div>

== Getting Started ==

To edit the wiki, you need:
# A Discord account
# The '''Wiki Contributor''' role in the [https://discord.gg/sasgaming SAS Gaming Discord]
# Click '''Log in''' (top right) and authenticate with Discord

Once logged in, you can edit any article, create new pages, upload images, and participate in discussions. Users without the Wiki Contributor role can still read everything and post on discussion (talk) pages.

== How Editing Works ==

Every game namespace on this wiki is sourced from an official community wiki and '''synced daily''':

{| class="wikitable" style="width:100%;"
|-
! Namespace !! Source Wiki !! Sync Time
|-
| [[ProjectGorgon:Main Page|ProjectGorgon]] || [https://wiki.projectgorgon.com wiki.projectgorgon.com] || Daily at 4 AM PT
|-
| [[Dragonwilds:Main Page|Dragonwilds]] || [https://dragonwilds.runescape.wiki dragonwilds.runescape.wiki] || Daily at 4 AM PT
|-
| [[Minecraft:Main Page|Minecraft]] || [https://minecraft.wiki minecraft.wiki] || Daily at 4 AM PT
|-
| [[StarCitizen:Main Page|StarCitizen]] || [https://starcitizen.tools starcitizen.tools] || Daily at 4 AM PT
|}

=== What happens during a sync ===

Every night, a sync bot checks each source wiki for new or updated pages from the last 24 hours. Here's what happens:

* '''Pages with no local edits''' — automatically updated from upstream. You won't notice anything.
* '''Pages you've edited''' — your changes are '''never overwritten'''. Instead:
** The upstream version is saved to a subpage (e.g., <code>ProjectGorgon:Sword/Upstream</code>)
** A banner appears at the top of your page: {{Upstream update available|Example/Upstream}}
** The page is added to [[:Category:Pages with upstream updates]] so editors can find it
* '''New upstream pages''' — imported automatically with no action needed.

== Editing a Synced Page ==

You are welcome and encouraged to edit any page! Common reasons to edit:

* '''Add SAS-specific tips''' — guild strategies, server-specific info, community knowledge
* '''Fix errors''' — correct wrong information, update outdated content
* '''Improve formatting''' — make pages look better on our dark theme
* '''Add content''' — fill in missing details the upstream wiki doesn't have

Your edits are permanent and will survive all future syncs. The sync system respects local contributions.

== Merging Upstream Updates ==

When you see the '''Upstream Update Available''' banner on a page you've edited:

# Click the link to view the upstream version (the <code>/Upstream</code> subpage)
# Compare it with the current page to see what changed upstream
# '''Cherry-pick''' the changes you want:
#* Open the current page in the editor
#* Copy relevant updates from the upstream version
#* Save the page with an edit summary like "Merged upstream changes"
# '''Remove the banner''' — delete the <code><nowiki>{{Upstream update available|...}}</nowiki></code> line from the page
# '''Delete the /Upstream subpage''' (optional) — it will be recreated if there's another upstream update

You do '''not''' need to merge everything. If the upstream change isn't relevant to our wiki or conflicts with SAS-specific content, just remove the banner and move on.

== Creating New Pages ==

You can create pages in any game namespace. A few tips:

* '''Use the namespace prefix''' — create <code>ProjectGorgon:My New Page</code>, not just <code>My New Page</code>
* '''Link from existing pages''' — add a link to your new page from a relevant existing article
* '''Follow existing formatting''' — look at other pages in the same namespace for style conventions

New pages you create will not be affected by the daily sync (since they don't exist upstream).

== Discussion Pages ==

Every article has a '''Discussion''' tab where you can:
* Ask questions about the content
* Suggest changes before making them
* Coordinate with other editors

All logged-in Discord users can post on discussion pages, even without the Wiki Contributor role. Just click the Discussion tab and start a new topic.

== Tips ==

* Use the '''Visual Editor''' (pencil icon) for a word-processor-like editing experience
* Use '''Source editing''' for more control over wikitext formatting
* Preview your changes before saving
* Write a brief '''edit summary''' so others know what you changed
* Check [[:Category:Pages with upstream updates]] periodically to help merge updates

== Need Help? ==

* Ask in the '''#wiki''' channel on [https://discord.gg/sasgaming Discord]
* Post on the [[SASGamingWiki talk:Editing guide|discussion page]] for this guide
* Check [[Special:RecentChanges]] to see what others are editing