Commit Graph

3 Commits

Author SHA1 Message Date
Martin
fb2cda86c7 Major documentation updates based on community feedback (Nov 2025)
Applied comprehensive corrections from Discord community (DeathStalker, Astrocast,
and others) to fix inaccuracies, remove outdated procedures, and improve readability.

CRITICAL SAFETY FIXES:
- IOMMU: Changed from "optional" to "MUST disable" across all docs
- Removed dangerous `amd_iommu=on` kernel parameter (causes crashes)
- Added danger warnings that IOMMU is broken on BC-250

BIOS & VRAM FIXES:
- Fixed BIOS flashing guide: removed fake "ZIP file" references
- Added link to actual flasher utility (separate from ROM download)
- Removed made-up Windows utility steps, added real ASRock method
- Removed AMIBCP/Smokeless section (not used, P5.00_clv has all unlocked)
- VRAM docs: reduced verbosity by 40%, emphasized 512MB is DYNAMIC
- Added ZRAM conflict warning (crashes in RDR2 with dynamic VRAM)

COOLING & HARDWARE:
- Removed impractical fin cutting/screwing instructions
- Removed J4003 header references (not for normal users)
- Added tower cooler downside (must cool VRAMs separately)
- Static pressure already correct at 6.9 mm H2O

LINUX DISTRIBUTION UPDATES:
- Fedora: Removed outdated setup script, Mesa 25.1 now in repos
- Fedora: nomodeset no longer needed on 42/43 with working kernels
- Bazzite: Removed "on steroids" section (patch included by default)
- CachyOS: Simplified from custom ISO to standard installation
- Updated KDE vs GNOME: GNOME recommended for stability (6 changes)
- SteamOS/Ubuntu: Already added in previous commit (verified)

GOVERNOR & DRIVERS:
- Prioritized COPR installation over building from source
- Added @exotic-soc/oberon-governor and filippor/bazzite repos
- Display adapters: Now recommend PASSIVE (audio works) over active

IMPOSSIBLE FEATURES REMOVED:
- Fortnite: Clarified it cannot run (Easy Anti-Cheat)
- ROCm training: Corrected to "experimental/limited" (doesn't work)

Desktop Environment: GNOME now recommended over KDE for stability
(KDE had Qt RDSEED bug, now fixed but GNOME more tested)

Files modified: 14
Community credits: DeathStalker, Astrocast, legodude
2025-11-22 16:12:30 +01:00
Martin
d64947030d Fix critical kernel version misinformation
Corrected kernel compatibility throughout documentation based on community feedback:

PREVIOUS (INCORRECT):
- Stated 'avoid kernel 6.15+' entirely
- Recommended only 6.12-6.14 LTS

CORRECTED:
- 6.15.0-6.15.6: Broken (GPU init fails)
- 6.15.7-6.17.7: Works (recommended, kernel support fixed)
- 6.17.8+: Broken again (GPU driver issues)
- 6.12-6.14 LTS: Still works (stable fallback)

Updated 15 files across all sections:
- Linux setup guides (Fedora, Arch, Debian, CachyOS, etc.)
- Troubleshooting (boot, display, performance, stability)
- Getting started guides
- Main index and quick reference
- Gaming compatibility

Thanks to Astrocast and DeathStalker for the correction.
2025-11-22 00:40:47 +01:00
Martin
b3bf9eb724 Initial commit: AMD BC250 Documentation
- MkDocs site with Material theme (teal/cyan, system theme matching)
- 20 comprehensive documentation pages
- Content from 9,716 Discord messages + GitHub sources
- GitHub Actions workflow for automated deployment
- Custom compact styling optimized for wide displays

Coverage:
- Getting Started (3 pages)
- Hardware (4 pages)
- BIOS & Firmware (4 pages)
- Linux Setup (4 pages)
- System Configuration (1 page)
- Gaming & Performance (1 page)
- Troubleshooting (1 page)
- Reference (1 page)
2025-11-21 21:59:00 +01:00