- Fixed broken Jinja2 template rendering (was showing raw code)
- Created custom workshops.html template with workshop data
- Simplified navigation title from full SEO title to 'Workshops'
- Added workshop post files for future blog integration
- Configured blog plugin for workshops (currently unused)
- Removed broken Jinja2 macro implementation
Changes:
- docs/workshops/index.md: Clean title, template directive
- mkdocs.yml: Blog plugin workshop configuration
- overrides/workshops.html: Static workshop template with FontAwesome icons
- docs/workshops/posts/: Individual workshop markdown files
- docs/templates/workshop-update-guide.md: Update documentation
Result: Clean, professional workshop page with proper VHS link handling
(upcoming workshops have links, past workshops don't)
* Add Lenna Alesi team profile page with comprehensive visual analysis capabilities
* Update team index to make Lenna Alesi clickable and add expanded description
* Update mkdocs.yml
add Lenna to Team
Signed-off-by: Jane Alesi <ja@satware.ai>
* Add John Alesi team profile page with comprehensive software development AGI capabilities
* Update team index to make John Alesi clickable and add expanded description
* Update mkdocs.yml to include John Alesi in navigation
* Add Lenna Alesi Team Profile - Advanced Visual Analysis Expert (#88)
* Add Lenna Alesi team profile page with comprehensive visual analysis capabilities
* Update team index to make Lenna Alesi clickable and add expanded description
* Update mkdocs.yml
add Lenna to Team
Signed-off-by: Jane Alesi <ja@satware.ai>
---------
Signed-off-by: Jane Alesi <ja@satware.ai>
* Update mkdocs.yml (#90)
Signed-off-by: Michael Wegener <mw@satware.com>
* Exchange of Silent Waves Logo
* Update mkdocs.yml to include John Alesi in navigation
* Add custom 404 page and preload optimizations for enhanced user experience.
- Include detailed, responsive HTML structure for `/404.html`.
- Optimize with critical CSS, meta tags, and deferred resource loading.
- Implement lazy loading, hover effects, and mobile navigation support.
- Add Font Awesome Pro stylesheet for consistent icon integration.
* feat: Implement internal documentation protection system
- Create docs/internal/ directory for internal documentation
- Configure mkdocs-exclude plugin to prevent publication
- Add .clinerules/satware-ai-dev.md for AI assistant enforcement
- Document internal documentation policy in README.md
- Move dev-ci-parity-analysis.md to protected location
CRITICAL FIX: Corrected glob pattern from 'internal/**/*' to 'internal/*'
(mkdocs-exclude plugin requires patterns relative to docs/ dir without
subdirectory wildcard for top-level exclusion)
TESTING VERIFIED:
✅ mkdocs build --clean completes without internal doc warnings
✅ site/internal/ directory does NOT exist in built output
✅ No traces of internal documents in site/ directory
✅ Build time improved (17.51s → 7.07s after exclusion)
Prevents accidental publication of internal development documentation
to public satware.ai website via multi-layer protection:
1. Build-time exclusion (mkdocs-exclude plugin)
2. Developer documentation (README.md policy section)
3. AI assistant enforcement (.clinerules/ MANDATORY rules)
4. Pre-commit verification procedures
* docs: Update .clinerules with verified glob pattern and testing procedures
CRITICAL UPDATE: Document correct mkdocs-exclude glob pattern
Key Changes:
- Add CRITICAL section documenting 'internal/*' vs 'internal/**/*' pattern
- Include verified testing procedures with expected outputs
- Add performance benchmarks (17.51s → 7.07s, 59% improvement)
- Consolidate redundant examples and verbose sections
- Streamline Rule #2 (AI behavior) and Rule #6 (documentation standards)
- Update version to 1.1
Testing Verified (2025-11-09):
✅ Pattern 'internal/*' excludes docs/internal/ from build
✅ Pattern 'internal/**/*' DOES NOT work (critical finding)
✅ All verification commands tested and documented
This update ensures future developers and AI assistants use the
correct glob pattern to prevent accidental publication of internal
documentation to the public satware.ai website.
* docs: Move and organize tasks.md to internal backlog
Move tasks.md to docs/internal/project-improvement-backlog.md
Key Changes:
- Renamed: tasks.md → docs/internal/project-improvement-backlog.md
- Added frontmatter (INTERNAL document metadata)
- Marked completed tasks from recent work:
✅ Internal documentation protection system
✅ CI/CD environment analysis
- Organized 43 pending tasks across 8 categories
- Added priority summary (Immediate/Short-term/Long-term)
- Updated status notes for tasks with existing work
- Added context notes about original file location
Purpose:
This backlog contains internal planning and development tasks
not intended for public consumption, so it belongs in the
protected docs/internal/ directory per .clinerules policy.
Categories:
1. Code Organization (5 tasks)
2. Documentation Quality (5 tasks)
3. Build Process (5 tasks)
4. Performance Optimizations (5 tasks)
5. Accessibility Improvements (5 tasks)
6. SEO Enhancements (5 tasks)
7. Content Structure (5 tasks)
8. Internationalization (5 tasks)
9. Testing & QA (5 tasks)
Total: 45 tasks (2 completed, 43 pending)
* chore: Add Gemfile.lock to .gitignore (orphaned file)
Gemfile.lock is an orphaned Ruby/Bundler file that should
not be tracked in this Python/MkDocs project.
Analysis:
- This is a MkDocs (Python) documentation project
- No Gemfile exists in the repository
- Gemfile.lock dated April 10, 2025 (likely leftover from test)
- Lock file cannot be regenerated without source Gemfile
- Ruby/Bundler not used in this project's build pipeline
Changes:
- Added Gemfile.lock to .gitignore
- Added comprehensive Ruby/Bundler ignore patterns:
- Gemfile.lock (the orphaned file)
- Gemfile (in case it appears)
- .bundle/ (Bundler configuration directory)
- vendor/bundle/ (Bundler gem installation directory)
This prevents future accidental commits of Ruby files in
this Python-based documentation project.
* docs: Add end-of-day session documentation (2025-11-09)
Session summary:
- 6 commits completed today
- Internal documentation protection system finalized
- .clinerules updated with verified patterns
- Project organization improvements
- All work safely committed and pushed
Status: Ready for next session
---------
Signed-off-by: Jane Alesi <ja@satware.ai>
Signed-off-by: Michael Wegener <mw@satware.com>
Co-authored-by: Michael Wegener <mw@satware.com>
Co-authored-by: Tim Friedrich Weber <tfw@satware.com>
tfw
jaandGitHub
