# SRMC Guide Style & Contribution Guidelines
This document outlines the standard structure, style, and components for creating new guide pages for the SRMC website. **SEO and User Retention are our primary goals.** Follow these guidelines to ensure consistency, high search ranking, and a premium user experience that keeps visitors engaged.
## 1. File Structure & Naming
- **File Extension:** `.html`
- **Location:** `/guide/` directory.
- **Naming Convention:** `snake_case` (e.g., `buried_treasure.html`, `bastion_routing.html`).
## 2. HTML Boilerplate
Every page must include the standard head elements, including Google Analytics, Fonts, CSS, and Scripts.
```html
Page Title - SRMC
← Back to Home
```
## 3. Content Structure
Inside the `` tag, follow this hierarchy:
1. **Back Link:** `← Back to Home`
2. **H1 Title:** Clear and descriptive.
3. **Intro Text:** `
...
`
4. **Media Placeholders:** Use comments for future media insertion.
5. **Sections:** Wrap distinct topics in ``.
6. **Headings:** Use `
` for main sections (often numbered) and `
` for subsections.
7. **Read Next:** `Read Next: Title`
## 4. Component Library
### Tip Box
Use for "Pro Tips", warnings, or crucial context.
```html
Pro Tip: Your tip text here.
```
### Lists
Use standard `
` or ``.
- Use `
` for feature lists or pros/cons.
- Use `` for sequential instructions.
### Media Placeholders
Visuals are critical for retention. Always include placeholders for **Images, Diagrams, or Video Embeds** to be added later.
```html
```
## 5. Tone & Voice
- **Audience:** Speedrunners (beginners and semi pro competitive, efficiency-focused).
- **Style:** Direct, imperative, and technical. Avoid fluff.
- **Keywords:** Use standard terminology (e.g., "One-Cycle", "Perch", "Chunk Coordinates").
## 6. Retention & Linking Strategy
To maximize retention and crawlability:
1. **"Read Next" Links:** Every page MUST end with a clear link to a relevant next topic to keep users on the site.
2. **New Guide Page Visibility:** Every newly created guide page MUST be linked from the Home Page (e.g., on other guide pages where this guide is related to, in a dedicated "Guides" section or index) to ensure discoverability.
3. **Internal Cross-Linking:** Link to other relevant terms or guides within the content text where appropriate.
## 7. SEO Checklist
- [ ] Unique `` tag ending with `- SRMC`.
- [ ] Unique `<meta name="description">` (approx 160 chars).
- [ ] Semantic `<h1>`, `<h2>`, `<h3>` hierarchy.
- [ ] Descriptive `alt` text for images (when added).