Skip to main content

Guide Writing Guidelines

Writing clear, helpful guides is essential to TheRSGuide's success. Follow these guidelines to ensure your contributions are valuable and consistent.

Structure

Title and Introduction

  • Use clear, descriptive titles
  • Start with a brief overview of what the guide covers
  • Mention any prerequisites or requirements upfront

Content Organization

  • Use logical headings and subheadings
  • Break complex processes into numbered steps
  • Include relevant screenshots or images
  • Add helpful tips in callout boxes

Example Structure

# [Activity Name] Guide

Brief description of the activity and what this guide covers.

## Requirements
- Skill levels needed
- Quest requirements
- Equipment needed

## Getting Started
Step-by-step instructions...

## Tips and Tricks
Helpful advice for efficiency...

## Rewards
What you can expect to gain...

Writing Style

Tone and Language

  • Write in a friendly, helpful tone
  • Use clear, simple language
  • Avoid jargon unless necessary
  • Assume the reader is new to the activity

Instructions

  • Use active voice ("Click the button" not "The button should be clicked")
  • Be specific about locations and actions
  • Include alternative methods when available
  • Warn about potential mistakes or dangers

Examples

Good:

  • "Walk north from Lumbridge Castle until you reach the chicken farm"
  • "Use your bronze axe on the regular tree to chop logs"

Avoid:

  • "Go to the place with the thing"
  • "Just do the skill"

Content Quality

Accuracy

  • Verify all information is current
  • Test methods yourself when possible
  • Include source links for game data
  • Update guides after major game updates

Completeness

  • Cover all essential steps
  • Include common variations
  • Address frequently asked questions
  • Provide alternatives for different skill levels

Helpfulness

  • Explain "why" not just "how"
  • Include time estimates
  • Mention efficiency tips
  • Warn about common pitfalls

Formatting

Markdown Usage

  • Use proper heading hierarchy (##, ###, ####)
  • Create bulleted lists for requirements
  • Use bold text for important terms
  • Include code blocks for requirements

Images and Media

  • Add relevant screenshots
  • Use descriptive alt text
  • Keep file sizes reasonable
  • Place images near relevant text

Review Checklist

Before submitting your guide, ensure:

  • All information is accurate and current
  • Instructions are clear and complete
  • Formatting follows the style guide
  • Images are properly placed and described
  • No typos or grammar errors
  • Content is helpful for the target audience

Getting Help

If you need assistance with writing your guide:

  • Check existing guides for examples
  • Ask questions in the community
  • Review feedback on similar guides
  • Use the style guide as a reference

Remember: Your guide will help countless players enjoy RuneScape more effectively. Take pride in creating something valuable for the community!