- 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>
* feat: Add mkdocs-redirects plugin configuration for /ja → /team/jane.html redirect
- Add redirects plugin to plugins section
- Configure redirect mapping for /ja to /team/jane.html
- Support multiple URL patterns and fallback redirects
- Fixes issue #99
* feat: Add fallback redirect page for /ja → /team/jane.html
- Create fallback redirect page with multiple redirect methods
- Include meta refresh, JavaScript redirect, and manual link
- Provides redundancy for redirect functionality
- SEO-friendly with proper meta tags
* feat: Add comprehensive redirect system for all team member Benutzerkürzel
- Implement satware AG Benutzerkürzel system for all team members
- Add redirects for all agents following collision resolution rules
- Support both direct and index patterns for each abbreviation
- Complete redirect mapping:
* AA → Amira, BA → Bastian, BEA → Bea (collision resolved)
* DA → Denopus, GA → Gunta, JA → Jane
* JOA → John, JUA → Justus (collision resolved)
* LA → Lara, LEA → Lenna, LEO → Leon, LUA → Luna
* MA → Marco, OA → Olu, TA → Theo, WA → Wolfgang
Fixes issue #99
* docs: Add comprehensive documentation for satware AG Benutzerkürzel redirect system
- Document complete redirect system implementation
- Include collision resolution rules and examples
- List all team member abbreviations and target URLs
- Provide testing instructions and troubleshooting guide
---------
Co-authored-by: Michael Wegener <mw@satware.com>
- Adjusted `mkdocs.sh` to expand SCSS watcher to include `docs` and `mkdocs.yml`.
- Simplified blog template by extracting post logic to `partials/post.html`.
- Updated `mkdocs.yml` with refined plugins including RSS, meta, and enhanced blog options.
- Improved blog Markdown files with structural changes and better TOC handling.
- Removed unused styles and deprecated logic in blog posts for cleaner maintenance.
* **Remove Python SCSS compiler and development script**
- Deleted `compile_scss.py` and `dev.sh` scripts to clean up unused SCSS compilation and local development workflow.
- Streamlining project by removing legacy Python-based tooling. Clear shift toward alternative CSS build processes in workflows.
* Migrate SCSS compilation to Python-based workflow and simplify Dockerfile
- Replaced Node.js SCSS tools with libsass and introduced `scss_watcher.py` for automated SCSS compilation during development.
- Updated Dockerfile to use Python-based dependencies and removed redundant npm configuration.
- Cleaned up `package.json`, `requirements.txt`, and outdated scripts to streamline the project.
- Enhanced development workflow with a lightweight Python-based approach.
* Replace `python -m sass` with `pysassc` for SCSS compilation in development scripts
* **Refactor and streamline MkDocs workflows, footer, and blog structure**
- Removed outdated `deploy-preview-fix.yml` and `deploy-test.yml` workflows for cleanup.
- Enhanced `deploy-preview.yml`:
- Expanded branch triggers to include `build/**`, `test/**`, and `preview/**`.
- Improved `site_url` logic by standardizing URL formatting.
- Updated `mkdocs.yml` navigation to use consistent `index.md` file naming.
- Simplified footer template to use relative paths for internal links (e.g., `impressum/`, `datenschutz/`).
- Adjusted `mkdocs.sh` to ensure SCSS watcher includes `overrides`.
- Deleted outdated `Sequential Thinking` blog and branch documentation for better maintenance.
* Update to Python 3.13 and streamline MkDocs workflows
- Upgraded Dockerfile base image to `python:3.13-slim-bullseye` for consistency with the latest Python version.
- Consolidated MkDocs and plugin installation steps in `deploy-preview.yml`.
- Replaced Node.js SCSS tools with Python `pysassc` for CSS build process, removing unnecessary npm steps.
* Replace `mkdocs-lightbox` with `mkdocs-glightbox` and improve CSS build step in GitHub Actions workflow
- Updated `deploy-preview.yml` to switch from `mkdocs-lightbox` to `mkdocs-glightbox` for better compatibility and features.
- Enhanced CSS build logic to create the target directory (`docs/assets/css`) if it does not exist, ensuring a smoother workflow execution.
* Streamline deploy workflows and enhance CSS build process
- Added repository-specific condition to `deploy-live.yml` for improved workflow targeting.
- Consolidated MkDocs and plugin installation steps in `deploy-live.yml` to remove redundant tasks.
- Enhanced CSS build step to ensure target directory creation (`mkdir -p docs/assets/css`) in both workflows.
* Add Leon Alesi team profile page with comprehensive IT system integration capabilities
* Update team index to make Leon Alesi clickable and add expanded description
* Add Leon Alesi to mkdocs.yml navigation
* Add Gunta Alesi team profile page
* Update team index to make Gunta Alesi clickable and add expanded description
* Add Gunta Alesi to mkdocs.yml navigation
* feature: Add Denopus Alesi team profile page
* Update Denopus Alesi entry in team index to be clickable and consistent
* Add Denopus Alesi to navigation in mkdocs.yml
* Add Wolfgang Alesi team profile page with comprehensive scientific research capabilities
* Update team index to make Wolfgang Alesi clickable and add expanded description
* Update contact form URL in Wolfgang Alesi team profile
* Add Wolfgang Alesi to mkdocs.yml navigation and remove duplicate Lenna
* 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
---------
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>
* 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>
* Neuer Blog-Beitrag: Wie moderne LLMs wirklich denken
* Update blog post to improve formatting
* Add modified workflow file to fix deployment
* Add README to blog post directory
* Fix YAML front matter quotes syntax
* Update MkDocs config to exclude README.md from blog posts
* Delete docs/blog/posts/README.md
Signed-off-by: Jane Alesi <ja@satware.ai>
* Fix Mermaid diagram styling for dark mode
* Add Jane Alesi as additional author
---------
Signed-off-by: Jane Alesi <ja@satware.ai>
* Remove unused font-face definitions from stylesheets
The `fonts.scss` file defining `Assistant` font-face rules has been deleted as it was no longer in use. This cleanup reduces unnecessary assets and improves maintainability.
* Fix npm script command in blog preview workflow
Replaced `npm scss:build` with the correct `npm run scss:build` command in the GitHub Actions workflow. This ensures the SCSS build step executes properly during site generation.
* Update blog preview workflow to use mkdocs gh-deploy
Replaces the GitHub Pages action with `mkdocs gh-deploy` for deploying previews. Simplifies the workflow configuration and reduces dependencies.
* Update `site_url` logic and fix URL format consistency
Simplified the `site_url` handling in the workflow by removing branch-specific URL construction. Additionally, ensured the main URL in `mkdocs.yml` uses a consistent trailing slash. This enhances clarity and maintains uniformity in URL formatting.
* Set `use_directory_urls` in mkdocs.yml directly.
Removed redundant script lines for configuring `use_directory_urls` in the workflow file. This simplifies deployment logic by directly defining the configuration in the mkdocs.yml file.
* Remove unnecessary CSS source map file
Deleted `custom.css.map` as it is not required for production. Removing it helps reduce clutter and keeps the repository clean.
* Add support for 'satware.ai' as a homepage path
Updated body-classes.js to treat 'satware.ai' as a homepage path by adding the 'home' class to the body element. This ensures correct behavior for both empty paths and specific developer GitHub Pages.
* Simplify FAQ and navigation structure.
Renamed `faq.md` to `index.md` for consistency and updated navigation links in `mkdocs.yml` to use folder paths directly. Adjusted `main.html` to clean up formatting with additional line breaks.
* Update footer links to use relative paths
Replaced absolute paths with relative paths for internal footer links to ensure consistency and improve maintainability. External links remain unchanged.
* Fix relative URL for Jane Alesi's team page in authors file
Updated the URL path for Jane Alesi to ensure correct navigation to her team page. This fixes a broken link caused by an incorrect relative URL.
* Update footer links and enhance blog post on website relaunch
Updated footer links to utilize dynamic `config.site_url` for consistent URL routing. Enhanced the blog post for better readability, showcasing the MkDocs implementation, GitHub integration, and use of Mermaid diagrams.
* Update footer link and simplify satWay documentation
Replaced the "Blog" link in the footer with "satWay Prinzipien" and refined the satWay documentation by removing overly detailed content about Jane Alesi. Additionally, added the Blog section to the site navigation in `mkdocs.yml`.
* Remove unused assets including logo and Lunr language files
Deleted the site logo SVG and minimized Lunr language files for Arabic and Danish. These assets were no longer needed and were removed to reduce unused files in the project.
* Add .repoinsight configuration for satware.ai project
This commit introduces a profile.yml file to configure RepoInsight for analyzing the satware.ai project. It specifies scan directories, exclusion patterns, LLM parameters, and output options to generate concise project insights. The configuration is tailored for efficient processing and markdown output.
* Add CNAME file for custom domain
This adds a CNAME file specifying "test.satware.ai" as the custom domain. It ensures proper domain configuration for the project’s documentation.
* Add Dockerfile for customized mkdocs-material setup
This Dockerfile sets up mkdocs-material with additional plugins to enhance functionality, such as macros, glightbox, and RSS support. It streamlines the process of configuring a tailored mkdocs environment for documentation needs.
* Refactor directory structure and update references
Moved documentation and team files to new directories, updated paths for assets and links, and adjusted MkDocs configuration accordingly. Added GitHub Actions workflow for test environment deployment, and updated `.gitignore` with `.cache` directory.
* Remove unused Font Awesome Pro stylesheet
Deleted an unused CSS file referencing Font Awesome Pro 6.7.1. This reduces unnecessary assets and ensures compliance with licensing terms.
* Fix typo in SCSS compilation script name in workflow
Corrected the script name from 'compily_scss.py' to 'compile_scss.py' in the deployment workflow. This ensures the CSS build step runs successfully during the deployment process.
* Add libsass installation step in deploy-test workflow
The deploy-test workflow now includes libsass in the dependencies to ensure proper build and styling support. This update resolves potential issues related to missing CSS preprocessor functionality.
* Add GitHub Actions workflow for live MkDocs deployment
This workflow automates the deployment of MkDocs to the live environment upon a push to the `live` branch. It includes dependency installation, site building, and deployment to GitHub Pages with custom domain support.
* Update deploy workflow to enhance build process
Replaced mkdocs-material installation with the imaging option for improved functionality. Added a new step to compile SCSS before building the site, ensuring styles are properly processed.
* Update deployment workflow and dependencies for GitHub Pages
Switched deployment branch to "main" and updated GitHub Actions workflow to align with current standards, including caching dependencies and using updated action versions. Revised dependencies in `requirements.txt` and corrected CNAME for production domain. Adjusted footer links in HTML override for improved consistency.
* Fix indentation in deploy-live workflow
Corrected the indentation for the 'mkdocs build' step in the deploy-live workflow file. This ensures proper execution of the workflow during deployment.
* Update deployment workflow to use 'live' branch
Changed the deployment branch from 'main' to 'live' in the workflow configuration. This ensures that only changes pushed to the 'live' branch trigger deployments to production.
* Update deploy step to use mkdocs gh-deploy
Replaces the GitHub Pages action with the native mkdocs gh-deploy command. This simplifies the workflow and ensures consistent deployment behavior. The `--force` flag is added to override potential publishing conflicts.
* Update team member links to use relative paths
Replaced absolute paths with relative paths for team member profiles in the team index page. This ensures better portability and consistency across different environments.
This commit introduces three new documentation files: `anwendungen.md` for AI solution use cases, `stylesheets/modules/blog.scss` for blog-specific styling, and `datenschutz.md` for the privacy policy. Additionally, it enhances blog author and sidebar styling for consistency and readability.
Removed `pointer-events: none` to enable hover effects on images and updated font weight for better visibility. Added new CSS for tooltips and modified navigation/yaml configuration for better presentation.
Introduce a modular SCSS structure to improve maintainability and organization of stylesheets. Add lightbox functionality for homepage screenshots, including responsive JavaScript behavior and custom styling for enhanced user experience. Update tasks documentation with improvement initiatives for the project.
Introduced mobile and medium responsiveness in stylesheets for better layout on smaller screens. Adjusted FAQ script to properly remove duplicate event listeners and ensure functionality remains smooth on initialization.
Reorganized font and image assets, replacing outdated files with new ones. Removed unused SVG icons and updated the sitemap with new URLs and last modified dates. Simplified font-face declarations to reflect the updated font structure.
Added WCAG-compliant scrolling behavior for search wrapper and updated styles for testimonials and team sections. Integrated alt attributes for images to improve accessibility and made minor layout refinements.
Introduced a testimonials section to the homepage, including JavaScript for interactive switching and automatic cycling, as well as responsive styles in SCSS. Users can now view dynamic testimonials with associated images and text.
Updated team member images, refined the SVG logo, and adjusted styles in the CSS for improved layout, typography, and hover effects. These changes enhance the visual design and user experience across the site.
Included a new `@import 'modules/home';` and added a re-usable `@mixin transition` for smoother animations. Updated button styling with padding, hover effects, and transitions to enhance UI. Adjusted max-width in `.team__inner` for better layout consistency.
Added various FontAwesome font assets for enhanced icon support in the project. Updated images of team members and removed an outdated JavaScript bundle."
Updated KI agent documentation to include trademark styling for "satware®" and introduced a new "zugang" page. Adjusted `.gitignore` and sitemap.xml to reflect site structure changes.
ja
tfw
