[Documentation] Update mcrogueface.github.io website #165

Closed
opened 2025-12-29 03:54:51 +00:00 by john · 1 comment
Owner

Summary

The website at https://mcrogueface.github.io/ exists but is out of date. It was generated from inline documentation but hasn't been refreshed recently.

Location

Repository: ~/Development/mcrogueface.github.io

Tasks

  1. Regenerate API documentation from current inline docs

    • Use tools/generate_dynamic_docs.py output
    • Ensure all new classes (Line, Circle, Arc, etc.) are included
  2. Update homepage content

    • Current version number
    • Download links to releases
    • Screenshot of current state
  3. Add tutorial section

    • Link to or embed getting-started guide
    • Progressive examples
  4. Verify all links work

    • Remove dead links
    • Update any moved content

Generation Process

The site was largely auto-generated from inline documentation. The same tooling should work:

# In McRogueFace repo
./build/mcrogueface --headless --exec tools/generate_dynamic_docs.py

# Copy output to website repo
cp docs/api_reference_dynamic.html ../mcrogueface.github.io/
  • #164 - Version identity (website should show current version)
  • Tutorial demo game issue
  • README polish issue
## Summary The website at https://mcrogueface.github.io/ exists but is out of date. It was generated from inline documentation but hasn't been refreshed recently. ## Location Repository: `~/Development/mcrogueface.github.io` ## Tasks 1. **Regenerate API documentation** from current inline docs - Use `tools/generate_dynamic_docs.py` output - Ensure all new classes (Line, Circle, Arc, etc.) are included 2. **Update homepage content** - Current version number - Download links to releases - Screenshot of current state 3. **Add tutorial section** - Link to or embed getting-started guide - Progressive examples 4. **Verify all links work** - Remove dead links - Update any moved content ## Generation Process The site was largely auto-generated from inline documentation. The same tooling should work: ```bash # In McRogueFace repo ./build/mcrogueface --headless --exec tools/generate_dynamic_docs.py # Copy output to website repo cp docs/api_reference_dynamic.html ../mcrogueface.github.io/ ``` ## Related - #164 - Version identity (website should show current version) - Tutorial demo game issue - README polish issue
Author
Owner

The content will never really be "done", not until McRogueFace is released and frozen. But an overhaul has made it much more organized.

The content will never really be "done", not until McRogueFace is released and frozen. But an overhaul has made it much more organized.
john closed this issue 2026-01-22 02:34:19 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
john/McRogueFace#165
No description provided.