Contributing to Wheel of Heaven

Thank you for your interest in contributing! This guide will help you get started.

Ways to Contribute

Content

• Fix typos or improve clarity
• Add missing translations
• Suggest new wiki entries or resources
• Report inaccuracies

Code

• Fix bugs
• Improve accessibility
• Enhance performance
• Add features

Other

• Report issues
• Suggest improvements
• Share the project

Getting Started

1. Find Something to Work On

• Check open issues
• Look for good first issue labels
• Or propose something new

2. Set Up Local Development

The fast path is the Quickstart — clone, build, preview in under five minutes. For the full dev environment (api, theme work, content-validation scripts), see Local Setup.

3. Make Your Changes

For content changes:

• Edit files in the data-content repository
• Follow the per-content-type guides at docs.wheelofheaven.world (Wiki Entry, Article, Newsroom Dispatch)
• Run validation: python scripts/validate.py

For theme/code changes:

• Edit files in bifrost (theme) or the site repos
• Follow existing code style
• Test locally with mise run serve

4. Submit a Pull Request

1. Fork the repository
2. Create a feature branch (git checkout -b my-feature)
3. Commit your changes
4. Push to your fork
5. Open a Pull Request

Repository Guide

Repo	What to Contribute
data-content	Wiki entries, translations, resources
bifrost	Templates, styles, JavaScript
www.wheelofheaven.io	Site configuration, static assets
docs.wheelofheaven.world	Documentation improvements

Translation

We support 9 languages. To help translate:

1. Check coverage: python scripts/i18n_dashboard.py
2. Find missing translations (ko and zh-Hant need the most help)
3. Create translation files mirroring English structure
4. Use the glossary for consistent terminology
5. Read the Translations guide for per-language conventions

Questions?

• Open a GitHub Discussion
• Join our Telegram

License

By contributing, you agree that your contributions will be licensed under CC0-1.0 (Public Domain).