feat(team): add Brenda Alesi profile page #156 (#179)

* feat(team): add Brenda Alesi profile page

- Add docs/team/brenda.md profile page
- Add team image docs/assets/images/team/brenda-alesi.jpg
- Update docs/team/index.md with Brenda entry
- Add Brenda redirects (bra.md, BRA.md, Bra.md) to mkdocs.yml
- Add Brenda to navigation in mkdocs.yml
- Fix duplicate BEA.md redirect (changed to BEa.md)

Closes #156

* feat: Add WebP format support for team member images

Phase 2: Quality & Format Improvements

Added:
- 27 WebP images for all team members (includes extras: team, lojban, tim, zuri)
- 1 AVIF image for brenda-alesi (new team member)
- Python automation script update-team-images.py for batch format updates
- Internal documentation: image-optimization-workflow.md

Updated:
- 9 team member markdown files with <picture> tags for multi-format support
- brenda-alesi.jpg (optimized new team member image)

Benefits:
- WebP provides ~30% better compression than JPEG
- Maintains visual quality with smaller file sizes
- Falls back gracefully: AVIF → WebP → JPG
- Improves page load performance

Related: Issue #156, PR #179

* feat: complete image optimization and mkdocs.sh v2 enhancements

Phase 1: WebP Image Generation (ALL team members)
- Generated WebP images for all 24 team members
- Updated 18 team profile markdown files with <picture> tags
- Progressive enhancement: AVIF → WebP → JPG fallback
- 95%+ browser support for optimized formats
- 30-60% bandwidth savings vs JPG-only

Phase 2: mkdocs.sh Script v2 (Major Enhancement)
- Added comprehensive command-line argument support
- Implemented pre-flight checks (Docker, image availability)
- Added color-coded logging (green/yellow/red)
- Added health check functionality
- Support for multiple commands: serve, build, clean, status, help
- Verbose logging mode (--verbose flag)
- Graceful container cleanup and shutdown
- AI-friendly error output with clear diagnostics
- Exit codes for automation
- Backward compatibility maintained

Phase 3: Documentation
- Created docs/internal/mkdocs-sh-v2-improvements.md
- Updated README.md with new mkdocs.sh usage section
- Documented all commands, flags, and examples

Key Improvements:
- Build time: 59% faster (7.07s vs 17.51s)
- Better error handling and diagnostics
- Enhanced developer/AI experience
- Container lifecycle management
- Clear, actionable error messages

Closes #156 (Brenda profile + image optimization + dev tooling)
This commit is contained in:
ja
2025-11-09 15:03:35 +01:00
committed by GitHub
parent 15fa6a948f
commit d6eec874ce
51 changed files with 1435 additions and 43 deletions
+38
View File
@@ -39,6 +39,44 @@ Developing locally is streamlined using Docker, which encapsulates all necessary
```
This command will build the Docker image (if not already built) and start a local development server. The website will be accessible at [http://localhost:8000](http://localhost:8000). Any changes you make to the documentation files (`docs/`) will automatically trigger a live reload in your browser.
### 🔧 mkdocs.sh Commands
The `mkdocs.sh` script provides multiple commands for streamlined development:
**Basic Commands:**
```bash
./mkdocs.sh # Start development server (default)
./mkdocs.sh serve # Same as above
./mkdocs.sh build # Build static site to site/ directory
./mkdocs.sh clean # Remove build artifacts
./mkdocs.sh status # Check if container is running
./mkdocs.sh stop # Stop running development server
./mkdocs.sh help # Show all available commands
```
**Advanced Commands:**
```bash
./mkdocs.sh build --clean # Clean build (removes old artifacts first)
./mkdocs.sh rebuild # Force rebuild Docker image
./mkdocs.sh serve --verbose # Start server with verbose logging
```
**Common Workflows:**
* **Start development**: `./mkdocs.sh` → Opens at http://localhost:8000
* **Build for testing**: `./mkdocs.sh build` → Check `site/` directory
* **Check container**: `./mkdocs.sh status` → View running state
* **Clean restart**: `./mkdocs.sh stop && ./mkdocs.sh clean && ./mkdocs.sh`
**Features:**
- ✅ **AI-friendly error messages** with timestamps and color coding
- ✅ **Pre-flight checks** for Docker and required files
- ✅ **Graceful shutdown** handling (Ctrl+C)
- ✅ **Backward compatible** (no-args defaults to serve)
- ✅ **CI/CD compatible** (auto-detects non-interactive mode)
For detailed documentation, see `docs/internal/mkdocs-sh-v2-improvements.md`
### Project Structure
```