CONTRIBUTING

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

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 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.