Skip to content

docs: pre-open-source documentation review#9

Merged
vitorfranklin merged 1 commit into
mainfrom
docs/pre-opensource-review
Jul 3, 2026
Merged

docs: pre-open-source documentation review#9
vitorfranklin merged 1 commit into
mainfrom
docs/pre-opensource-review

Conversation

@vitorfranklin

Copy link
Copy Markdown
Owner

Documentation review before opening the project to the community.

Fixes

  • CONTRIBUTING.md: replaced the outdated "No tests yet" section — the project has a 45-test pytest suite in tests/unit/; added instructions to run it and pointed at the least-covered modules (services/player.py, services/storage.py).
  • ARCHITECTURE.md: fixed env var name RETROHOST_WEBRTC_HOSTHOMEGAMES_WEBRTC_HOST (the one actually read by docker-entrypoint.sh).
  • ARCHITECTURE.md: fixed CIFS mount point /mnt/retrohost-roms/mnt/homegames-roms (matches config.py).
  • ARCHITECTURE.md: added tests/, pytest.ini and compose.yml to the project structure listing.
  • README.md: fixed broken TOC anchor for the Quick Start section (missing underscore in x86_64).
  • README.md: replaced commercial ROM examples (Crash Bandicoot, Super Mario World) with freely distributed homebrew — Magic Castle (PS1, Net Yaroze) and Super Boss Gaiden (SNES) — with official download links, so the example doubles as a legal way to test the setup.
  • README.md: documented docker compose up -d as an alternative to docker run.
  • Replaced <repo-url> placeholders (5 occurrences) with the real repository URL.
  • Added personal notes file to .gitignore.

🤖 Generated with Claude Code

- CONTRIBUTING: replace outdated 'No tests yet' with real pytest instructions
- ARCHITECTURE: fix env var name (RETROHOST_WEBRTC_HOST -> HOMEGAMES_WEBRTC_HOST)
- ARCHITECTURE: fix CIFS mount point (/mnt/retrohost-roms -> /mnt/homegames-roms)
- ARCHITECTURE: add tests/, pytest.ini and compose.yml to project structure
- README: fix broken TOC anchor for Quick Start section
- README: replace commercial ROM examples with free homebrew (Magic Castle,
  Super Boss Gaiden) with official download links
- README: document docker compose as an alternative to docker run
- Replace <repo-url> placeholders with the real repository URL
- gitignore personal notes file

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vitorfranklin vitorfranklin merged commit 006d701 into main Jul 3, 2026
2 checks passed
@vitorfranklin vitorfranklin deleted the docs/pre-opensource-review branch July 3, 2026 01:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant