Update comprehensive documentation for Alpha release (Issue #47)

- Completely rewrote README.md to reflect 7DRL 2025 success and current features
- Updated GitHub Pages documentation site with:
  - Modern landing page highlighting Crypt of Sokoban
  - Comprehensive API reference (2700+ lines) with exhaustive examples
  - Updated getting-started guide with installation and first game tutorial
  - 8 detailed tutorials covering all major game systems
  - Quick reference cheat sheet for common operations
- Generated documentation screenshots showing UI elements
- Fixed deprecated API references and added new features
- Added automation API documentation
- Included Python 3.12 requirement and platform-specific instructions

Note: Text rendering in headless mode has limitations for screenshots

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -1,30 +1,85 @@
-# McRogueFace - 2D Game Engine
+# McRogueFace
 
-An experimental prototype game engine built for my own use in 7DRL 2023.
+A Python-powered 2D game engine for creating roguelike games, built with C++ and SFML.
 
-*Blame my wife for the name*
+**Latest Release**: Successfully completed 7DRL 2025 with *"Crypt of Sokoban"* - a unique roguelike that blends Sokoban puzzle mechanics with dungeon crawling!
 
-## Tenets:
+## Features
 
-* C++ first, Python close behind.
-* Entity-Component system based on David Churchill's Memorial University COMP4300 course lectures available on Youtube.
-* Graphics, particles and shaders provided by SFML.
-* Pathfinding, noise generation, and other Roguelike goodness provided by TCOD.
+- **Python-First Design**: Write your game logic in Python while leveraging C++ performance
+- **Rich UI System**: Sprites, Grids, Frames, and Captions with full animation support
+- **Entity-Component Architecture**: Flexible game object system with Python integration
+- **Built-in Roguelike Support**: Dungeon generation, pathfinding, and field-of-view via libtcod
+- **Automation API**: PyAutoGUI-compatible testing and demo recording
+- **Interactive Development**: Python REPL integration for live game debugging
 
-## Why?
+## Quick Start
 
-I did the r/RoguelikeDev TCOD tutorial in Python. I loved it, but I did not want to be limited to ASCII. I want to be able to draw pixels on top of my tiles (like lines or circles) and eventually incorporate even more polish.
+```bash
+# Clone and build
+git clone https://github.com/jmcb/McRogueFace.git
+cd McRogueFace
+make
 
-## To-do
+# Run the example game
+cd build
+./mcrogueface
+```
 
-* ✅ Initial Commit
-* ✅ Integrate scene, action, entity, component system from COMP4300 engine
-* ✅ Windows / Visual Studio project
-* ✅ Draw Sprites
-* ✅ Play Sounds
-* ✅ Draw UI, spawn entity from Python code
-* ❌ Python AI for entities (NPCs on set paths, enemies towards player)
-* ✅ Walking / Collision
-* ❌ "Boards" (stairs / doors / walk off edge of screen)
-* ❌ Cutscenes - interrupt normal controls, text scroll, character portraits
-* ❌ Mouse integration - tooltips, zoom, click to select targets, cursors
+## Example: Creating a Simple Scene
+
+```python
+import mcrfpy
+
+# Create a new scene
+mcrfpy.createScene("intro")
+
+# Add a text caption
+caption = mcrfpy.Caption(50, 50, "Welcome to McRogueFace!")
+caption.font = mcrfpy.default_font
+caption.font_color = (255, 255, 255)
+
+# Add to scene
+mcrfpy.sceneUI("intro").append(caption)
+
+# Switch to the scene
+mcrfpy.setScene("intro")
+```
+
+## Documentation
+
+For comprehensive documentation, tutorials, and API reference, visit:
+**[https://mcrogueface.github.io](https://mcrogueface.github.io)**
+
+## Requirements
+
+- C++17 compiler (GCC 7+ or Clang 5+)
+- CMake 3.14+
+- Python 3.12+
+- SFML 2.5+
+- Linux or Windows (macOS untested)
+
+## Project Structure
+
+```
+McRogueFace/
+├── src/           # C++ engine source
+├── scripts/       # Python game scripts
+├── assets/        # Sprites, fonts, audio
+├── build/         # Build output directory
+└── tests/         # Automated test suite
+```
+
+## Contributing
+
+McRogueFace is under active development. Check the [ROADMAP.md](ROADMAP.md) for current priorities and open issues.
+
+## License
+
+This project is licensed under the MIT License - see LICENSE file for details.
+
+## Acknowledgments
+
+- Developed for 7-Day Roguelike Challenge 2025
+- Built with [SFML](https://www.sfml-dev.org/), [libtcod](https://github.com/libtcod/libtcod), and Python
+- Inspired by David Churchill's COMP4300 game engine lectures