# Documentation

New here? Start at the [project README](../README.md).

Pick the guide that matches your situation.

**Live demos:** [v3](https://paladini.github.io/ghost-on-github-pages-demo/) · [Classic v2 archive](https://paladini.github.io/ghost-on-github-pages-demo/legacy/v2/static/)

## Start here

| Situation | Guide |
|-----------|-------|
| **I am setting up a new blog** | [v3 Getting Started](v3/GETTING-STARTED.md) |
| **I already use the old (Classic) version** | [Migration guide](MIGRATION.md) |
| **I want the Classic version on purpose** | [Legacy docs](legacy/README.md) |
| **Something went wrong** | [Troubleshooting](TROUBLESHOOTING.md) |
| **I do not understand a word** | [Glossary](GLOSSARY.md) |

## Version 3 guides

- [What to install first](v3/REQUIREMENTS.md)
- [Getting started — new blog](v3/GETTING-STARTED.md)
- [How to publish changes](v3/DEPLOY.md)
- [Multiple GitHub repositories (optional)](v3/MULTI-REPO.md)

## Classic version 2.x (maintenance)

- [Classic overview](legacy/README.md) — downloads and when to use each release
- [Known issues by release](legacy/KNOWN-ISSUES.md)
- Full Classic guides on branch [`classic/v2`](https://github.com/paladini/ghost-on-github-pages/tree/classic/v2/docs/legacy)

## Other guides

- [Migrate from v2 to v3](MIGRATION.md)
- [Troubleshooting & FAQ](TROUBLESHOOTING.md)
- [Glossary of terms](GLOSSARY.md)
- [Contributing](../CONTRIBUTING.md)