jekyll-theme-zer0 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6efa1fb4e9fdc23aa63e90c94762e62c2f568a379133ca8674f78b6c2ed19046
-  data.tar.gz: c9eba9e9cff455d23cdeebdbc92facbafc0a6ec6063c366cfeb7819a044a3cc6
+  metadata.gz: ce41ce999bd5b54f7cfcac020229d628824553947a7afb5b06d7c4b4b70a8359
+  data.tar.gz: 8aa1e03d1a80f7e3dbd4e48bd60b6032f9b92937b2d4b6659917d5be1450dd4a
 SHA512:
-  metadata.gz: e9a4fa8676d4589896c9feaa8fd9e440e6bb1c76e686c5b5860d3a9112e873ac2cb4f98543391495456236e689bce451a1de36285de122c6793210914baa62c9
-  data.tar.gz: da070bafa01bfd3a7507da4160a31f396b94c1163299c788cab1aeaa011291f1e6955ddf29128c4045425821feea34a83bf62290f7c75183fd411e48099deece
+  metadata.gz: 294d8297f16eb43703c573cfb7fc731d27ef2927062873653899c19e72866c1fec39d9844c5706458705dafa04621d431c06284582a113fb310cebf18cc85585
+  data.tar.gz: '0299069c10c3fa32846c4879f4accc6ac555998c36fd8f9cffca821090839743301469d1894cc79b3bcb9f3b1c127bd1497335b3c3e6b17390235b15e7390be8'

data/CHANGELOG.md

@@ -1,5 +1,79 @@
 # Changelog
 
+## [0.22.0] - 2026-04-01
+
+### Added
+- **Copilot Agent dropdown**: New `btn-success` dropdown in the intro section action button group that lists AI prompt templates, each opening a pre-filled GitHub issue assigned to `@copilot` with the selected prompt body, page context, and environment metadata
+- **`_data/prompts.yml`**: Data-driven prompt registry with 9 built-in templates (article-review, code-implementation, code-refactoring, debugging, documentation, requirements-analysis, system-design, test-generation, prompt-engineering)
+- **`docs/implementation/copilot-agent-prompt-button.md`**: Full implementation guide covering architecture, configuration, prompt registry, issue body structure, customization, troubleshooting, and FAQ
+
+### Changed
+- **`_includes/content/intro.html`**: Replaced single Copilot Agent link with a prompt-selection dropdown; `repo_branch` now sourced from `site.branch | default: "main"` (fixes hardcoded `master`); file path uses dedicated `file_path` variable; issue title format is `[Prompt Label] Page Title` with `ai-agent` label pre-applied
+- **`docs/implementation/README.md`**: Added Copilot Agent Prompt Button entry to contents table
+
+## [0.21.6] - 2026-03-30
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 56c70b8 docs: fix Quick Links, harmonize bash commands, and update version references across READMEs (#42)
+
+
+## [0.21.5] - 2026-03-30
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- c74f26d Automate README.md version sync and fix GitHub release dispatch in release workflow (#40)
+
+
+## [0.21.4] - 2026-03-29
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 3c96620 feat: vendor assets, theme architecture, CI and docs (v0.21.3) (#39)
+
+
+## [0.21.3] - 2026-03-29
+
+### Changed
+- **Test runner**: When `test.conf` sets a non-default `TEST_TIMEOUT_DEFAULT`, pass `--timeout` only to suites whose scripts accept it (`core`, `deployment`, `quality`). Avoids `Unknown option: --timeout` on installation and site-generation suites.
+- **Vendor assets (GitHub Pages)**: Bootstrap, jQuery, Bootstrap Icons, MathJax, Mermaid, Font Awesome, and GitHub Calendar load from committed `assets/vendor/` with `relative_url` (no runtime CDN for core assets). Added `vendor-manifest.json`, `scripts/vendor-install.sh`, and `npm run vendor:install`. `.gitignore` uses `/vendor/` for Bundler only; removed blanket `vendor/` from Jekyll `exclude` so `assets/vendor/` is published. Docker base image includes `jq` for vendor installs; `scripts/bin/build` runs vendor-install before gem build.
+- **Mermaid vendor source**: `mermaid` is a devDependency; `npm run vendor:mermaid` copies `node_modules/mermaid/dist/mermaid.min.js` into `assets/vendor/mermaid/`. The jsDelivr Mermaid entry was removed from `vendor-manifest.json`; `vendor-install.sh` copies from npm when `node_modules` is present.
+- Version bump: patch release
+- **CSS architecture**: Removed unused `assets/css/custom.css` (legacy `#mainNav`); overrides use `_sass/custom.scss` or optional `user-overrides.css`. Replaced vendored `_sass/core/_docs.scss` (~3.2k lines) with trimmed `_sass/core/_docs-layout.scss`. Theme modes: `_sass/theme/_color-modes.scss` re-exports `_wizard-mode.scss` (wizard Sass/CSS) and `_css-variables.scss` (`--bd-*` tokens); dropped duplicate blocks from `_theme.scss`, duplicate Bootstrap font/line-height block in `_variables.scss`, and unused social/base16 duplicates from `_variables.scss`. Feature metadata now points styles at `_docs-layout.scss`.
+- **Optional npm Bootstrap**: Added `package.json` with `npm run css:bootstrap` (Dart Sass + Bootstrap 5.3.3) producing `assets/css/vendor/bootstrap-from-npm.css`; documented alternate `<link>` in `_includes/core/head.html`. `stats.css` remains a conditional stylesheet for the stats layout only.
+
+### Commits in this release
+- 1fd2061 Enhance navigation UX: responsive design, accessibility, and interaction polish (#25)
+- 9a27ad7 feat(aieo): add structured data, E-E-A-T signals, FAQ, glossary, and roadmap pages (#38)
+- 96a31f9 chore(deps): update Ruby gem dependencies (#37)
+
+
+## [0.21.2] - 2026-03-21
+
+### Changed
+- Version bump: patch release
+- Release tooling: RubyGems publishing now supports API-key auth via `.env` (`RUBY_API_KEY` mapped to `GEM_HOST_API_KEY`)
+
+### Commits in this release
+- 34bed37 chore(deps): update Ruby gem dependencies (#31)
+- 50ebdd4 chore(deps): update Ruby gem dependencies (#32)
+
+## [0.21.1] - 2026-03-13
+
+### Changed
+- Version bump: patch release
+
+### Commits in this release
+- 9665afd feat(templates): add README.md for templates directory and usage instructions
+- cc81bd9 chore(deps): update Ruby gem dependencies (#24)
+
+
 ## [0.21.0] - 2026-02-01
 
 ### Added

data/README.md

@@ -2,7 +2,7 @@
 title: zer0-mistakes
 sub-title: Jekyll Theme
 description: GitHub Pages compatible Jekyll theme with Bootstrap 5.3, featuring automated installation and comprehensive documentation.
-version: 0.19.1
+version: 0.21.6
 layout: landing
 tags:
   - jekyll
@@ -14,7 +14,7 @@ categories:
   - docker
   - bootstrap
 created: 2024-02-10T23:51:11.480Z
-lastmod: 2026-01-25T00:00:00.000Z
+lastmod: 2026-03-30T15:07:00.000Z
 draft: false
 permalink: /
 slug: zer0
@@ -23,7 +23,7 @@ keywords:
   - docker
   - remote-theme
   - github-pages
-date: 2026-01-25T12:00:00.000Z
+date: 2026-03-29T12:00:00.000Z
 snippet: GitHub Pages compatible Jekyll theme with Bootstrap 5
 comments: true
 mermaid: true
@@ -62,8 +62,11 @@ excerpt: "Professional Jekyll theme for GitHub Pages with Bootstrap 5.3, automat
 - [Documentation](#-documentation)
 - [Release System](#-release-system)
 - [Roadmap](#-roadmap)
+- [FAQ](/faq/)
+- [Glossary](/glossary/)
 - [Contributing](#-contributing)
 - [Support](#-support)
+- [AIEO-Optimized](#-aieo-optimized--built-for-ai-citation)
 
 ---
 
@@ -98,9 +101,9 @@ graph LR
 
 | Challenge | Traditional Jekyll | zer0-mistakes |
 |-----------|-------------------|---------------|
-| **Setup Time** | 15-30 minutes | **2-5 minutes** |
-| **Success Rate** | ~60% | **~95%** |
-| **Platform Support** | Limited | **Universal** |
+| **Setup Time** | 15-30 minutes | **2-5 minutes** ([benchmarked via install.sh](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
+| **Success Rate** | ~60% | **~95%** ([self-healing error recovery](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh#L1)) |
+| **Platform Support** | Limited | **Universal** ([macOS, Linux, Windows/WSL via Docker](https://github.com/bamr87/zer0-mistakes/blob/main/docker-compose.yml)) |
 | **Error Handling** | Manual debugging | **Automated** |
 | **Dependencies** | Ruby + Bundler + Jekyll | **Docker only** |
 
@@ -129,22 +132,22 @@ docker-compose up
 ```mermaid
 sequenceDiagram
     participant You
-    participant Install Script
+    participant InstallScript as Install Script
     participant Docker
     participant Browser
-    
-    You->>Install Script: curl ... | bash
-    Install Script->>Install Script: Detect platform
-    Install Script->>Install Script: Download theme files
-    Install Script->>Install Script: Configure Docker
-    Install Script-->>You: ✅ Ready!
-    
+
+    You->>InstallScript: curl ... | bash
+    InstallScript->>InstallScript: Detect platform
+    InstallScript->>InstallScript: Download theme files
+    InstallScript->>InstallScript: Configure Docker
+    InstallScript-->>You: ✅ Ready
+
     You->>Docker: docker-compose up
     Docker->>Docker: Build Jekyll container
     Docker->>Docker: Install dependencies
     Docker-->>Browser: Serve on :4000
-    
-    Browser-->>You: 🎉 Live site!
+
+    Browser-->>You: 🎉 Live site
 ```
 
 ---
@@ -411,7 +414,7 @@ docker-compose up
 
 ```ruby
 # Gemfile
-gem "jekyll-theme-zer0", "~> 0.19"
+gem "jekyll-theme-zer0", "~> 0.21"
 ```
 
 ---
@@ -455,9 +458,9 @@ graph TD
 |-----------|---------|-----------|
 | `_layouts/` | Page templates | `default.html`, `journals.html`, `landing.html`, `notebook.html` |
 | `_includes/` | Reusable components | `core/`, `components/`, `analytics/`, `navigation/` |
-| `_sass/` | Stylesheets | `custom.scss`, `notebooks.scss`, `core/` |
-| `assets/` | Static files | `css/`, `js/sidebar.js`, `images/` |
-| `scripts/` | Automation | `release`, `build`, `convert-notebooks.sh` |
+| `_sass/` | Stylesheets | `custom.scss`, `notebooks.scss`, `core/` (`_variables`, `_docs-layout`, …), `theme/` (`_css-variables`, `_wizard-mode`) |
+| `assets/` | Static files | `css/`, `js/`, `images/`, **`vendor/`** (Bootstrap, jQuery, MathJax, Mermaid, … — committed for GitHub Pages) |
+| `scripts/` | Automation | `release`, `build`, `vendor-install.sh`, `convert-notebooks.sh` |
 | `docs/` | Technical docs | `SIDEBAR_IMPROVEMENTS.md`, `JUPYTER_NOTEBOOKS.md` |
 | `pages/` | Content pages | `privacy-policy.md`, `terms-of-service.md` |
 
@@ -506,6 +509,19 @@ git commit -m "feat: add new component"
 
 # Docker-specific tests
 ./test/test_docker_deployment.sh
+
+# Visual / styling checks (Playwright; optional BASE_URL if site already running)
+npm run test:styling
+```
+
+### Vendor assets (maintainers)
+
+Third-party CSS and JavaScript live under `assets/vendor/` so GitHub Pages builds work without npm at publish time. To refresh bundles after changing versions, see [Vendor assets](pages/_docs/development/vendor-assets.md) (published at `/docs/development/vendor-assets/`). Short version:
+
+```bash
+npm install
+npm run vendor:install    # manifest downloads (+ Mermaid copy when node_modules present)
+# or: ./scripts/vendor-install.sh
 ```
 
 ---
@@ -585,14 +601,14 @@ graph LR
 
 | Resource | Description |
 |----------|-------------|
-| [📋 Technical Docs]({{ site.resources.github_repo | default: '' | join: '' }}/tree/{{ site.branch }}/docs/) | Architecture, systems, implementation |
-| [📖 User Guides]({{ '/docs/' | relative_url }}) | Published tutorials and references |
-| [🎨 Customization]({{ '/docs/customization/' | relative_url }}) | Layouts, styles, navigation guides |
-| [📊 Analytics]({{ '/docs/analytics/' | relative_url }}) | PostHog, Google Analytics setup |
-| [🔍 SEO]({{ '/docs/seo/' | relative_url }}) | Meta tags, sitemap, structured data |
-| [📓 Jupyter Notebooks]({{ site.resources.github_repo | default: '' | join: '' }}/blob/{{ site.branch }}/docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
+| [📋 Technical Docs](https://github.com/bamr87/zer0-mistakes/tree/main/docs/) | Architecture, systems, implementation |
+| [📖 User Guides](https://zer0-mistakes.com/docs/) | Published tutorials and references |
+| [🎨 Customization](https://zer0-mistakes.com/docs/customization/) | Layouts, styles, navigation guides |
+| [📊 Analytics](https://zer0-mistakes.com/docs/analytics/) | PostHog, Google Analytics setup |
+| [🔍 SEO](https://zer0-mistakes.com/docs/seo/) | Meta tags, sitemap, structured data |
+| [📓 Jupyter Notebooks](https://github.com/bamr87/zer0-mistakes/blob/main/docs/JUPYTER_NOTEBOOKS.md) | Notebook conversion documentation |
 | [📝 PRD](docs/PRD.md) | Product requirements & roadmap |
-| [🔒 Privacy Policy]({{ '/privacy-policy/' | relative_url }}) | GDPR/CCPA compliant privacy docs |
+| [🔒 Privacy Policy](https://zer0-mistakes.com/privacy-policy/) | GDPR/CCPA compliant privacy docs |
 
 ---
 
@@ -633,18 +649,20 @@ flowchart LR
 
 ```bash
 # Preview release
-/opt/homebrew/bin/bash scripts/release patch --dry-run
+bash scripts/release patch --dry-run
 
 # Full release
-/opt/homebrew/bin/bash scripts/release patch  # 0.19.1 → 0.19.2
-/opt/homebrew/bin/bash scripts/release minor  # 0.19.1 → 0.20.0
-/opt/homebrew/bin/bash scripts/release major  # 0.19.1 → 1.0.0
+bash scripts/release patch  # 0.21.5 → 0.21.6
+bash scripts/release minor  # 0.21.5 → 0.22.0
+bash scripts/release major  # 0.21.5 → 1.0.0
 ```
 
 ---
 
 ## 🗺 Roadmap
 
+See the full [Roadmap page](/roadmap/) for detailed plans and timeline.
+
 ```mermaid
 gantt
     title zer0-mistakes Roadmap
@@ -653,19 +671,22 @@ gantt
     v0.17 ES6 Navigation      :done, 2025-12, 2025-12
     v0.18 Site Search         :done, 2026-01, 2026-01
     v0.19 Feature Discovery   :done, 2026-01, 2026-01
+    v0.20 Navigation Redesign :done, 2026-02, 2026-02
+    v0.21 Env Switcher        :done, 2026-02, 2026-03
     section Current
-    v0.19.x Maintenance       :active, 2026-01, 2026-02
+    v0.22 AIEO Optimization   :active, 2026-03, 2026-04
     section Future
-    v0.20 CMS Integration     :2026-02, 2026-04
-    v0.21 i18n Support        :2026-05, 2026-07
-    v1.0 Production Ready     :milestone, 2027-01, 1d
+    v0.23 CMS Integration     :2026-05, 2026-07
+    v0.24 i18n Support        :2026-07, 2026-09
+    v1.0 Stable Release       :milestone, 2027-01, 1d
 ```
 
 | Version | Target | Features |
 |---------|--------|----------|
-| **v0.19** | Current | 43 documented features, comprehensive documentation |
-| **v0.20** | Q1 2026 | Headless CMS integration, content API |
-| **v0.21** | Q2 2026 | Multi-language support (i18n) |
+| **v0.21** | Completed | Environment switcher, navigation redesign, settings modal |
+| **v0.22** | Q1 2026 | AIEO optimization, structured data, FAQ, glossary |
+| **v0.23** | Q2 2026 | Headless CMS integration, content API |
+| **v0.24** | Q3 2026 | Multi-language support (i18n) |
 | **v1.0** | Q1 2027 | Stable API, 90%+ test coverage |
 
 ---
@@ -710,7 +731,7 @@ git push origin feature/awesome-feature
 
 | Channel | Link |
 |---------|------|
-| 📖 Documentation | [zer0-mistakes.org](https://bamr87.github.io/zer0-mistakes/) |
+| 📖 Documentation | [zer0-mistakes.com](https://zer0-mistakes.com/) |
 | 🐛 Issues | [GitHub Issues](https://github.com/bamr87/zer0-mistakes/issues) |
 | 💬 Discussions | [GitHub Discussions](https://github.com/bamr87/zer0-mistakes/discussions) |
 | 📧 Email | [support@zer0-mistakes.com](mailto:support@zer0-mistakes.com) |
@@ -721,12 +742,31 @@ git push origin feature/awesome-feature
 
 | Metric | Value |
 |--------|-------|
-| **Current Version** | 0.19.1 |
-| **Documented Features** | 43 |
-| **Setup Time** | 2-5 minutes |
-| **Documentation Pages** | 70+ |
-| **RubyGems Downloads** | 3,000+ |
-| **Lighthouse Score** | 95+ |
+| **Current Version** | 0.21.6 ([RubyGems](https://rubygems.org/gems/jekyll-theme-zer0), [CHANGELOG](/CHANGELOG)) |
+| **Documented Features** | 43 ([Feature Registry](https://github.com/bamr87/zer0-mistakes/blob/main/_data/features.yml)) |
+| **Setup Time** | 2-5 minutes ([install.sh benchmarks](https://github.com/bamr87/zer0-mistakes/blob/main/install.sh)) |
+| **Documentation Pages** | 70+ ([browse docs](/pages/)) |
+| **RubyGems Downloads** | 3,000+ ([rubygems.org](https://rubygems.org/gems/jekyll-theme-zer0)) |
+| **Lighthouse Score** | 95+ ([measured via Chrome DevTools](https://developer.chrome.com/docs/lighthouse/)) |
+
+---
+
+## 🤖 AIEO-Optimized — Built for AI Citation
+
+This site implements [AI Engine Optimization (AIEO)](https://zer0-mistakes.com/glossary/#aieo) to maximize accuracy and depth when AI models cite or summarize its content. Key patterns applied:
+
+| AIEO Pattern | Implementation |
+|---|---|
+| **Structured Data** | JSON-LD `SoftwareApplication`, `WebPage`, `Person`, and `FAQPage` schemas in every page head |
+| **Entity Density** | Author profiles, technology names, and version numbers linked to canonical sources |
+| **E-E-A-T Signals** | Visible [author block](/glossary/#e-e-a-t) on the landing page with social proof links |
+| **FAQ Injection** | Dedicated [FAQ page](/faq/) with 12 question-answer pairs and FAQPage schema |
+| **Definitional Precision** | Machine-readable [Glossary](/glossary/) with 20+ key term definitions |
+| **Temporal Anchoring** | Dated [Roadmap](/roadmap/) with past, present, and future milestones |
+| **Substantiated Claims** | Project stats table links to RubyGems, CHANGELOG, and Feature Registry as evidence |
+| **Procedural Clarity** | Step-by-step installation with Mermaid sequence diagrams and comparison tables |
+
+All AIEO enhancements are backward-compatible, follow existing code style (Bootstrap 5.3, Liquid templates), and add zero runtime overhead on pages that don't use them.
 
 ---
 
@@ -745,6 +785,6 @@ Built with these amazing technologies:
 
 **Built with ❤️ for the Jekyll community**
 
-**v0.19.1** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
+**v0.21.6** • [Changelog](CHANGELOG.md) • [License](LICENSE) • [Contributing](CONTRIBUTING.md)
 
 

data/_data/authors.yml

@@ -25,12 +25,21 @@ default:
   role: "Development Team"
 
 bamr87:
-  name: "Amr Bakri"
-  bio: "Creator of Zer0-Mistakes Jekyll theme. Developer, automation enthusiast, and Docker advocate."
+  name: "Amr Abdel-Motaleb"
+  display_name: "Amr Abdel (bamr87)"
+  bio: "Creator of zer0-mistakes and the AIEO methodology. Developer, automation enthusiast, and Docker advocate building tools for the Jekyll community."
   avatar: "/images/authors/bamr87.png"
   github: "bamr87"
   twitter: "bamr87"
-  role: "Lead Developer"
+  linkedin: "bamr87"
+  website: "https://zer0-mistakes.com"
+  role: "Creator & Lead Developer"
+  expertise:
+    - "Jekyll theme development"
+    - "Docker containerization"
+    - "AI Engine Optimization (AIEO)"
+    - "GitHub Pages deployment"
+    - "Bootstrap UI frameworks"
 
 guest:
   name: "Guest Author"

data/_data/features.yml

@@ -205,7 +205,7 @@ features:
         - "_includes/navigation/sidebar-right.html"
         - "_includes/navigation/sidebar-categories.html"
         - "_includes/navigation/sidebar-folders.html"
-      styles: ["_sass/core/_docs.scss", "_sass/custom.scss"]
+      styles: ["_sass/core/_docs-layout.scss", "_sass/custom.scss"]
       docs: "docs/SIDEBAR_IMPROVEMENTS.md"
     features:
       - "Intersection Observer scroll spy"

data/_data/glossary.yml

@@ -0,0 +1,101 @@
+# Glossary Data File
+# ==================
+# Key terms and definitions used throughout the zer0-mistakes theme.
+# Used by: pages/glossary.md
+#
+# Fields:
+#   term: The term being defined (required)
+#   definition: A clear, concise definition (required)
+#   url: Link to learn more (optional)
+#   related: Related terms (optional)
+
+- term: "Jekyll"
+  definition: "A static site generator written in Ruby that transforms plain text files (Markdown, Liquid templates) into a complete website. Jekyll is the engine behind GitHub Pages and powers zer0-mistakes."
+  url: "https://jekyllrb.com/"
+  related: ["Liquid", "GitHub Pages", "Ruby"]
+
+- term: "Liquid"
+  definition: "An open-source template language created by Shopify and used by Jekyll. Liquid uses tags ({% %}), objects ({{ }}), and filters to render dynamic content in static HTML pages."
+  url: "https://shopify.github.io/liquid/"
+  related: ["Jekyll", "Includes"]
+
+- term: "Bootstrap"
+  definition: "A front-end CSS and JavaScript framework for building responsive, mobile-first websites. zer0-mistakes uses Bootstrap 5.3.3 for its grid system, components, and utility classes."
+  url: "https://getbootstrap.com/"
+  related: ["Responsive Design", "SCSS"]
+
+- term: "Docker"
+  definition: "A platform for developing, shipping, and running applications inside lightweight, portable containers. zer0-mistakes uses Docker as the primary development environment to ensure cross-platform consistency."
+  url: "https://www.docker.com/"
+  related: ["Docker Compose", "Docker-First"]
+
+- term: "Docker Compose"
+  definition: "A tool for defining and running multi-container Docker applications using a YAML configuration file (docker-compose.yml). In zer0-mistakes, docker-compose up starts the full development environment."
+  url: "https://docs.docker.com/compose/"
+  related: ["Docker"]
+
+- term: "Docker-First"
+  definition: "A development philosophy where Docker containers are the primary and recommended development environment. This ensures all developers get identical behavior regardless of their host operating system."
+  related: ["Docker", "Docker Compose"]
+
+- term: "GitHub Pages"
+  definition: "A free static site hosting service from GitHub that builds Jekyll sites directly from a repository. zer0-mistakes is fully compatible with GitHub Pages using the remote_theme configuration."
+  url: "https://pages.github.com/"
+  related: ["Jekyll", "Remote Theme"]
+
+- term: "Remote Theme"
+  definition: "A Jekyll configuration that loads a theme from a GitHub repository instead of installing it locally. Configured via remote_theme: bamr87/zer0-mistakes in _config.yml for GitHub Pages compatibility."
+  related: ["GitHub Pages", "Jekyll"]
+
+- term: "Mermaid"
+  definition: "A JavaScript-based diagramming and charting library that renders Markdown-like text into diagrams (flowcharts, sequence diagrams, Gantt charts, etc.). Enabled per-page in zer0-mistakes with mermaid: true in front matter."
+  url: "https://mermaid.js.org/"
+  related: ["Markdown"]
+
+- term: "MathJax"
+  definition: "A JavaScript display engine for mathematical notation (LaTeX, MathML, AsciiMath). Loaded asynchronously in zer0-mistakes for rendering equations in blog posts and documentation."
+  url: "https://www.mathjax.org/"
+
+- term: "PostHog"
+  definition: "An open-source product analytics platform. zer0-mistakes integrates PostHog for privacy-compliant analytics with cookie consent, respecting Do Not Track settings and GDPR/CCPA requirements."
+  url: "https://posthog.com/"
+  related: ["Analytics", "Cookie Consent"]
+
+- term: "Front Matter"
+  definition: "A YAML block at the top of Jekyll files (between --- delimiters) that defines metadata such as layout, title, date, tags, and custom variables. Front matter drives Jekyll's template rendering."
+  related: ["Jekyll", "YAML"]
+
+- term: "SCSS"
+  definition: "Sassy CSS — a CSS preprocessor that adds variables, nesting, mixins, and other features to standard CSS. Jekyll compiles SCSS files from _sass/ into production CSS automatically."
+  related: ["Bootstrap", "CSS"]
+
+- term: "Semantic Versioning"
+  definition: "A versioning scheme using MAJOR.MINOR.PATCH format where MAJOR indicates breaking changes, MINOR indicates new backward-compatible features, and PATCH indicates backward-compatible bug fixes. zer0-mistakes follows SemVer strictly."
+  url: "https://semver.org/"
+  related: ["CHANGELOG"]
+
+- term: "AIEO"
+  definition: "AI Engine Optimization — a methodology for making web content maximally citable by AI systems. Includes structured data, entity density, E-E-A-T signals, FAQ injection, glossary definitions, and temporal anchoring."
+  related: ["JSON-LD", "E-E-A-T", "Structured Data"]
+
+- term: "E-E-A-T"
+  definition: "Experience, Expertise, Authoritativeness, and Trustworthiness — quality signals used by search engines and AI systems to evaluate content credibility. zer0-mistakes implements E-E-A-T through author profiles, structured data, and cited claims."
+  related: ["AIEO", "Structured Data"]
+
+- term: "JSON-LD"
+  definition: "JavaScript Object Notation for Linked Data — a method of encoding structured data in JSON format using Schema.org vocabulary. zer0-mistakes uses JSON-LD scripts in the HTML head for SoftwareApplication, FAQPage, and Person schemas."
+  url: "https://json-ld.org/"
+  related: ["Schema.org", "Structured Data", "AIEO"]
+
+- term: "Schema.org"
+  definition: "A collaborative vocabulary for structured data markup on web pages. Schema.org types (SoftwareApplication, Person, FAQPage, etc.) help search engines and AI understand page content."
+  url: "https://schema.org/"
+  related: ["JSON-LD", "Structured Data"]
+
+- term: "Cookie Consent"
+  definition: "A user-facing mechanism that requests permission before storing cookies or tracking data. zer0-mistakes includes a GDPR/CCPA-compliant cookie consent banner with granular preference management."
+  related: ["PostHog", "GDPR"]
+
+- term: "SRI (Subresource Integrity)"
+  definition: "A security feature that lets browsers verify that resources fetched from CDNs have not been tampered with. zer0-mistakes uses SRI hashes on all CDN-loaded Bootstrap CSS and JS files."
+  related: ["Bootstrap", "CDN"]

data/_data/navigation/docs.yml

@@ -130,6 +130,18 @@
     - title: Bootstrap Overview
       url: /docs/bootstrap/
 
+# ============================================================
+# Development
+# ============================================================
+- title: Development
+  icon: bi-tools
+  url: /docs/development/testing/
+  children:
+    - title: Testing
+      url: /docs/development/testing/
+    - title: Vendor assets
+      url: /docs/development/vendor-assets/
+
 # ============================================================
 # Help
 # ============================================================

data/_data/navigation/home.yml

@@ -7,8 +7,8 @@
   icon: bi-house
   url: /
   children:
-    - title: Blog
-      url: /blog/
+    - title: News
+      url: /news/
     - title: Quick Start
       url: /quickstart/
 

data/_data/navigation/main.yml

@@ -48,14 +48,8 @@
   children:
     - title: All Notebooks
       url: /notebooks/
-    - title: Pandas Data Analysis
-      url: /notebooks/pandas-data-analysis/
-    - title: Matplotlib Visualization
-      url: /notebooks/matplotlib-visualization/
-    - title: Python Statistics
-      url: /notebooks/python-statistics/
-    - title: API Requests
-      url: /notebooks/api-requests/
+    - title: Test Notebook
+      url: /notebooks/test-notebook/
 
 - title: Docs
   icon: bi-journal-bookmark