8b0bc7f70cdf5fbfd55d0971b831df7a0d028f07
8
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
 tfw
|
92718e9743 | Structure of "Webinar" Page with now subpages | ||
  
|
15fa6a948f |
feat: Internal documentation protection system + team profiles + UX improvements (#178)
* 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> |
||
|
|
0d1de78799 |
Fix/64 logo navi fehlt bei mobile ansicht auf ipad bspw quer (#3)
* Update .gitignore to include custom.css.map Added a reference to custom.css.map to prevent it from being tracked by Git. This helps avoid committing autogenerated files and keeps the repository clean. * Fix layout issues for iPad and tablet landscape view Updated responsive styles to ensure proper visibility and alignment of header elements and navigation on devices with widths between 768px and 1220px. Adjusted logo, spacing, font sizes, and layout to improve usability and appearance. Disabled the hamburger menu to avoid conflicts in this viewport range. * Fix layout issues for iPad and tablet landscape view Updated responsive styles to ensure proper visibility and alignment of header elements and navigation on devices with widths between 768px and 1220px. Adjusted logo, spacing, font sizes, and layout to improve usability and appearance. Disabled the hamburger menu to avoid conflicts in this viewport range. * Add workflow_dispatch trigger to preview workflows Enable manual execution for preview deployment workflows by adding the `workflow_dispatch` trigger. This allows users to start the workflows manually when necessary, improving flexibility and control. * Set default font to "Assistant" in base.scss Removed an unnecessary comment and ensured the root uses "Assistant" as the default font. This improves code clarity while maintaining consistent styling. --------- Co-authored-by: Tim Friedrich Weber <tfw@satware.com> |
||
|
ja
|
a28518edcd | Delete lowercase readme.md and enforce case sensitivity in gitignore | ||
|
mwandGitHub
|
9fbea33697 |
Blog/2025 05 20 test blog post (#51)
* 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`. |
||
|
mwandGitHub
|
9ec744a042 |
Live (#50)
* 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. |
||
|
tfw
|
0f629dc7a3 |
Add trademark formatting and sitemap updates
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. |
||
|
tfw
|
65e0169c37 | Initial commit |