RetroTechCollection

Help:Editing

Revision as of 13:48, 2 August 2025 by Josh (talk | contribs)
Editing Guide
Your comprehensive guide to editing and contributing to RetroTechCollection Wiki

Welcome editors! This guide covers everything from basic text formatting to advanced editing techniques. Whether you're fixing a typo or writing comprehensive articles about vintage technology, you'll find the information you need here.

📚 Before You Begin

Prerequisites

  • You must be 13 years or older to edit
  • You need a registered account to edit pages
  • New users must make 3 quality contributions before gaining autoconfirmed status
  • Review our Terms of Use and Getting Started guide

Core Editing Principles

Principle Description Example
Neutral Point of View Present facts without bias "The ZX Spectrum had 16KB of RAM" not "The ZX Spectrum had only 16KB of RAM"
Verifiability All claims need reliable sources Add citations for specifications, dates, and claims
No Original Research Don't publish your own findings Use published sources, not personal experiments
Collaborative Spirit Work with other editors Discuss major changes on talk pages first

✏️ Basic Editing

Accessing the Editor

There are several ways to edit a page:

  1. Edit entire page: Click the "Edit" tab at the top
  2. Edit section: Click the [edit] link next to any section heading
  3. Visual Editor: Use the "Edit" button for WYSIWYG editing (if enabled)
  4. Source Editor: Use "Edit source" for direct wikitext editing

The Editing Interface

When you click edit, you'll see:

  • Edit toolbar: Buttons for common formatting
  • Edit window: Where you type your changes
  • Edit summary box: Explain your changes (required)
  • Preview button: See how your changes will look
  • Save button: Publish your changes
  • Show changes: Compare your version with the current

Making Your First Edit

  1. Find a page that needs improvement
  2. Click "Edit"
  3. Make your changes in the edit window
  4. Write a clear edit summary (e.g., "Fixed typo in specifications")
  5. Click "Show preview" to check your work
  6. Click "Save changes" when satisfied

💡 Pro tip: Always preview your changes before saving! This helps catch formatting errors and ensures your edit looks correct.

🖋️ Wiki Markup Fundamentals

Text Formatting

You type You get Notes
''italic text'' italic text Two apostrophes on each side
'''bold text''' bold text Three apostrophes on each side
'''''bold italic''''' bold italic Five apostrophes on each side
<u>underlined</u> underlined Use sparingly
<s>strikethrough</s> strikethrough For corrections
<code>inline code</code> inline code For commands, filenames
<small>small text</small> small text For annotations
<big>big text</big> big text Deprecated, use sparingly
H<sub>2</sub>O H2O Subscript
E=mc<sup>2</sup> E=mc2 Superscript
You type Result Usage
[[Commodore 64]] Commodore 64 Basic link
[[Commodore 64|C64]] C64 Link with custom text
[[Commodore 64#History]] Commodore 64#History Link to section
[[Commodore 64#History|C64 History]] C64 History Section link with custom text
[[Category:Home computers]] (adds page to category) Categorize page
[[:Category:Home computers]] Category:Home computers Link to category page
[[File:Example.jpg]] (embeds image) Embed image
[[:File:Example.jpg]] File:Example.jpg Link to image page
You type Result
https://example.com https://example.com
[https://example.com] [1]
[https://example.com Example site] Example site
[https://example.com Example site] (archived) Example site (archived)

Headings and Sections

= Heading 1 = (Never use - reserved for page title)
== Heading 2 == (Main sections)
=== Heading 3 === (Subsections)
==== Heading 4 ==== (Sub-subsections)
===== Heading 5 ===== (Rarely used)
====== Heading 6 ====== (Avoid if possible)

Best practices:

  • Start with level 2 headings (==)
  • Don't skip levels (e.g., don't go from 2 to 4)
  • Keep heading names concise and descriptive
  • Avoid links in headings
  • Capitalize only the first word and proper nouns

Lists

Unordered Lists

* First item
* Second item
** Sub-item
** Another sub-item
*** Third level
* Back to first level

Results in:

  • First item
  • Second item
    • Sub-item
    • Another sub-item
      • Third level
  • Back to first level

Ordered Lists

# First step
# Second step
## Sub-step 2.1
## Sub-step 2.2
# Third step

Results in:

  1. First step
  2. Second step
    1. Sub-step 2.1
    2. Sub-step 2.2
  3. Third step

Definition Lists

; Term 1
: Definition 1
; Term 2
: Definition 2a
: Definition 2b

Results in:

Term 1
Definition 1
Term 2
Definition 2a
Definition 2b

Paragraphs and Line Breaks

  • Paragraphs: Leave a blank line between paragraphs
  • Line break: Use <br /> for forced line break
  • Indentation: Start line with : (each colon adds a level)
  • Preformatted text: Start line with space

Example: 

This is a paragraph.

This is another paragraph.

:This is indented once.
::This is indented twice.

Line one<br />
Line two (forced break)

 This text is preformatted
 and preserves spacing

📊 Tables

Basic Table Structure

{| class="wikitable"
|+ Table caption (optional)
|-
! Header 1
! Header 2
! Header 3
|-
| Row 1, Cell 1
| Row 1, Cell 2
| Row 1, Cell 3
|-
| Row 2, Cell 1
| Row 2, Cell 2
| Row 2, Cell 3
|}

Advanced Table Features

{| class="wikitable sortable" style="width:100%;"
|+ Commodore Computer Specifications
|-
! Model !! Year !! CPU !! RAM !! Price
|-
| Commodore 64 || 1982 || MOS 6510 @ 1MHz || 64KB || $595
|-
| Commodore 128 || 1985 || MOS 8502 @ 2MHz || 128KB || $299
|-
| colspan="5" style="text-align:center;" | ''Prices are US MSRP at launch''
|}

Results in:

Commodore Computer Specifications
Model Year CPU RAM Price
Commodore 64 1982 MOS 6510 @ 1MHz 64KB $595
Commodore 128 1985 MOS 8502 @ 2MHz 128KB $299
Prices are US MSRP at launch

🖼️ Working with Images

Uploading Images

1. Go to Special:Upload 2. Choose your file 3. Give it a descriptive name (e.g., "Apple_IIe_motherboard_front.jpg") 4. Fill out the information form: 

{{Information
|description = Front view of Apple IIe motherboard showing all components
|source = {{own}}
|date = 2024-01-15
|author = [[User:YourUsername]]
|permission = 
|other_versions = 
}}

Image Syntax

Purpose Syntax Example
Basic embed [[File:Example.jpg]] Displays full-size image
Thumbnail [[File:Example.jpg|thumb|Caption text]] Creates thumbnail with caption
Sized image [[File:Example.jpg|200px]] Sets width to 200 pixels
Left align [[File:Example.jpg|left|thumb|Caption]] Floats image left
Center [[File:Example.jpg|center|300px]] Centers image
Gallery <gallery>...</gallery> Creates image gallery 
<gallery mode="packed" heights="150">
File:Apple_II.jpg|Apple II (1977)
File:Apple_IIplus.jpg|Apple II+ (1979)
File:Apple_IIe.jpg|Apple IIe (1983)
File:Apple_IIc.jpg|Apple IIc (1984)
</gallery>

📝 Citations and References

Why Citations Matter

  • Verify information accuracy
  • Allow readers to learn more
  • Establish credibility
  • Protect against deletion

Basic Citation Format

The Commodore 64 sold over 12 million units.<ref>{{cite book
|last = Bagnall
|first = Brian
|title = Commodore: A Company on the Edge
|year = 2010
|publisher = Variant Press
|isbn = 978-0973864960
|page = 224
}}</ref>

Common Citation Templates

Book Citation

{{cite book
|last = 
|first = 
|title = 
|year = 
|publisher = 
|isbn = 
|page = 
}}

Magazine Citation

{{cite magazine
|last = 
|first = 
|title = 
|magazine = 
|issue = 
|date = 
|pages = 
|url = 
}}

Web Citation

{{cite web
|url = 
|title = 
|website = 
|date = 
|access-date = 
|archive-url = 
|archive-date = 
}}

Reference List

Add at the bottom of the article: 

== References ==
{{reflist}}

== External links ==
* [https://example.com Official website]

[[Category:Appropriate category]]

🎨 Templates

Using Templates

Templates provide consistent formatting. Common templates include:

Infoboxes

{{Infobox computer
|name = Commodore 64
|image = Commodore-64.jpg
|caption = The best-selling computer model of all time
|manufacturer = [[Commodore International]]
|type = [[Home computer]]
|release date = August 1982
|discontinued = April 1994
|processor = [[MOS Technology 6510|MOS 6510]] @ 1.023 MHz
|memory = 64 KB RAM, 20 KB ROM
|graphics = [[VIC-II]] (320×200, 16 colors)
|sound = [[SID chip|SID 6581]]
}}

Message Boxes

{{Warning|This procedure may damage your equipment if not done correctly.}}

{{Note|The original manual contains additional information not covered here.}}

{{Tip|Use a proper anti-static wrist strap when handling components.}}

{{Commodore computers}}
{{Home computers of the 1980s}}

🔧 Advanced Techniques

Magic Words

Magic word Output Usage
{{PAGENAME}} Editing Current page name
{{CURRENTDAY}} 13 Current day
{{CURRENTMONTHNAME}} July Current month
{{CURRENTYEAR}} 2026 Current year
__TOC__ (forces table of contents) Position TOC
__NOTOC__ (hides table of contents) Hide TOC
__NOEDITSECTION__ (hides edit links) Hide section editing

Parser Functions

{{#if: {{{parameter|}}} | Parameter exists | Parameter missing }}

{{#ifeq: {{{type}}} | computer | [[Category:Computers]] | [[Category:Other]] }}

{{#switch: {{{year}}}
| 1977 = Early era
| 1982 = Golden age
| 1985 = Late period
| #default = Unknown era
}}

Redirects

Create redirects for alternate names: 

#REDIRECT [[Commodore 64]]

Common redirect scenarios:

  • Abbreviations (C64 → Commodore 64)
  • Alternative spellings
  • Common misspellings
  • Previous names

⚡ Editing Best Practices

Before Editing

1. **Check page history** - See what changes have been made recently 2. **Read talk page** - Check for ongoing discussions 3. **Verify sources** - Ensure your information is accurate 4. **Plan major changes** - Discuss big edits on talk page first

While Editing

1. **Use preview** - Check your work before saving 2. **Edit incrementally** - Make focused changes 3. **Write clear summaries** - Explain what and why 4. **Cite sources** - Add references for new facts 5. **Check spelling** - Proofread your contributions

Edit Summaries

Good edit summaries help other editors:

Type of edit Example summary
Fixing typo "Fixed typo: 'Comodore' → 'Commodore'"
Adding content "Added specifications section with sources"
Removing content "Removed unsourced claim about sales figures"
Formatting "Formatted specifications as table"
Citation "Added citation for release date"
Major revision "Restructured article per talk page consensus"

Common Mistakes to Avoid

❌ Don't ✅ Do Instead
Write in first person ("I think...") Use third person neutral tone
Add personal opinions Stick to verifiable facts
Copy from other websites Write in your own words
Use lots of exclamation points!!! Use professional tone
WRITE IN ALL CAPS Use normal capitalization
Leave test edits Use your sandbox for testing
Ignore preview button Always preview before saving
Make massive changes without discussion Discuss major changes first

🚨 Handling Conflicts

Edit Conflicts

If someone edits the page while you're editing: 1. Don't panic - your work isn't lost 2. Copy your text to a text editor 3. Review the other person's changes 4. Incorporate both sets of changes 5. Save the merged version

Content Disputes

1. **Stay calm** - Don't edit war 2. **Discuss** - Use the talk page 3. **Provide sources** - Back up your position 4. **Seek consensus** - Find common ground 5. **Get help** - Ask for third opinion if needed

The Three-Revert Rule

Don't revert the same page more than three times in 24 hours. Instead:

  • Discuss on the talk page
  • Seek mediation
  • Request page protection if necessary

📋 Quick Reference

Essential Shortcuts

  • Bold: '''text'''
  • Italic: ''text''
  • Link: [[Page name]]
  • External: [https://example.com Text]
  • Heading: == Heading ==
  • List: * Item
  • Reference: <ref>Source</ref>
  • Sign talk pages: ~~~~

Keyboard Shortcuts

  • **Alt+Shift+P** - Preview
  • **Alt+Shift+S** - Save
  • **Alt+Shift+V** - View history
  • **Alt+Shift+E** - Edit page
  • **Alt+Shift+T** - Talk page

🆘 Getting Help

Help Resources

Finding Mentors

🎯 Next Steps

Now that you understand editing basics:

1. **Practice in your sandbox** 2. **Start with small edits** - Fix typos, add links 3. **Expand stubs** - Add content to short articles 4. **Create new articles** - Document missing systems 5. **Join a WikiProject**

Ready to start editing?
Find an article about your favorite vintage system and improve it!
Remember: Be bold, but be careful. Happy editing!

Questions? Visit the Help desk or leave a message on this page's talk page.

Retrieved from "https://wiki.retrotechcollection.com/index.php?title=Help:Editing&oldid=4460"