# Contributing to the BC-250 Unofficial Community Guide

> Turn a $50-150 mining board into a Linux gaming PC — community-tested hardware guides, benchmarks, and troubleshooting for the AMD BC-250.

Thank you for your interest in contributing! This guide relies on tested, verified information from the BC-250 Discord community.

## How to Contribute

### 1. Fork & Clone
```bash
git clone https://github.com/katzzero/bc250-unofficial-community-guide.git
cd bc250-unofficial-community-guide
```

### 2. Make Your Changes
- Edit existing files or add new ones in the `/Revised/` directory
- Keep the numbered file structure (01-*) for consistency
- Use clear headers, tables, and code blocks

### 3. Verify Your Claims
- Cross-reference with the [elektricM/amd-bc250-docs](https://github.com/elektricM/amd-bc250-docs) repo
- Test any commands or configurations before suggesting them
- Provide sources (URLs, ASINs, commit hashes) for any new information

### 4. Submit a Pull Request
- Ensure your branch is up to date with `origin/main`
- Write a clear commit message describing your changes
- Include what you tested and where you verified the information

## What We Need
- ✅ Tested hardware configurations
- ✅ Game compatibility reports
- ✅ Troubleshooting solutions
- ✅ Distribution-specific setup steps
- ✅ Fixes for outdated information
- ✅ New benchmarks and performance data

## Guidelines
- **English only** — all documentation must be written in English. If source material is in another language, translate before submitting.
- **Do not guess** — if you're unsure, mark it as unverified
- **Always cite sources** for technical specifications
- **Keep it reader-friendly** — use tables, headers, and clear formatting
- **Sync the wiki** — after your PR is merged, the maintainer syncs the guide to the GitHub Wiki

## Reporting Issues
Open a GitHub Issue if you find:
- Factual errors
- Broken links
- Outdated information
- Missing content

---

*This guide was restructured from community Discord data, the elektricM/amd-bc250-docs repository, and verified against current internet sources.*