Changelog

[0.22.13] - 2026-04-10

Changed

• Version bump: patch release

Commits in this release

• 3c00a3d refactor: remove duplicate code — use standard libraries and existing plugins (#59)

[0.22.12] - 2026-04-10

Changed

• Version bump: patch release

Commits in this release

• 7ba0f83 feat(news): add data-driven feature showcase & live Bootstrap components to news index (#54)

[0.22.11] - 2026-04-09

Changed

• Version bump: patch release

Commits in this release

• 8e83a51 Create SECURITY.md for security policy and reporting

[0.22.10] - 2026-04-06

Changed

• Version bump: patch release

Commits in this release

• 27550da feat(admin): add admin layout and configuration dashboards (#57)

[0.22.9] - 2026-04-05

Added

• Skin Editor: New colorffy-inspired skin editor (assets/js/skin-editor.js) for creating and customizing theme skins from the browser
  • Edit all 9 built-in skin gradient colors with live color pickers
  • Auto-generated palettes: primary tints, surface, tonal surface, semantic colors (success/warning/danger/info)
  • WCAG contrast ratio badges on all palette swatches
  • Random skin generation, save/load custom skins to localStorage
  • Export SVGs and copy CSS custom properties to clipboard
  • Advanced SVG filter controls (turbulence, octaves, seed, scale, overlay opacity)
• Palette Generator: New standalone palette generator (assets/js/palette-generator.js) with chroma.js-powered color mixing and live CSS variable editor
• Playwright Tests: 12 new visual regression test specs (skins, backgrounds, accessibility, admin layout, config editor/viewer, env dashboard, security, theme colors)

Fixed

• Skin Rendering: Added .zer0-bg-hero class to landing layout to prevent Bootstrap .bg-primary from overriding skin background gradients
• CSS Scoping: Added .bg-primary:not(.zer0-bg-hero) in custom SCSS to isolate skin backgrounds from Bootstrap utility classes

Changed

• Theme Customizer: Expanded to 6 tabs — added Skin Editor between Skins and Palette Generator
• Admin Navigation: Minor layout adjustment
• Environment Dashboard: Minor component update

[0.22.8] - 2026-04-04

Changed

• Version bump: patch release

Commits in this release

• e0b4f13 fix: cross-platform installation compatibility — Gemfile platform sections, fork mode tests, portable sed replacements (#55)

[0.22.7] - 2026-04-03

Changed

• Version bump: patch release

Commits in this release

• a70ae8a chore: consolidate configuration, dependencies, and installation (PRs #48, #51, #52, #53) (#51)

Unreleased — Universal Installer

Added

• Installer: New --remote install mode — forks repo and creates an orphan gh-pages branch with only the bare minimum files needed to render via remote_theme (no local theme source)
• Installer: New --github install mode — interactive fork via gh CLI with automatic platform detection and setup
• Installer: New --codespaces flag — adds .devcontainer/devcontainer.json for GitHub Codespaces support (auto-included in remote mode, opt-in for full/minimal)
• Installer: Cross-platform setup scripts: scripts/platform/setup-macos.sh, setup-linux.sh, setup-wsl.sh
• Installer: GitHub CLI fork/clone helper: scripts/github-setup.sh
• Installer: Platform auto-detection (detect_platform()) for macOS, Linux, and WSL
• Templates: _config.remote.yml.template — minimal config for remote-theme consumer sites
• Templates: _config.starter.yml.template — heavily annotated full starter config
• Templates: Gemfile.remote.template — minimal Gemfile (github-pages + jekyll-remote-theme)
• Templates: devcontainer.json.template — lightweight devcontainer for consumer sites
• Templates: theming.md.template — Bootstrap 5 customization guide (dark mode, typography, layouts)
• Templates: setup.html.template — dev-only setup wizard page
• Wizard: Interactive browser-based config wizard (pages/setup.html, _includes/setup/wizard.html, assets/js/setup-wizard.js) for generating _config.yml via a 5-step Bootstrap form
• CI: .github/workflows/setup-template.yml — auto-detects non-upstream repos and creates PR with prefilled config

Changed

• Installer: install.sh — added --remote, --github, --codespaces flags and corresponding mode dispatchers
• Installer: render_template() now substitutes REPOSITORY_NAME, RAW_GITHUB_URL, FORK_GITHUB_USER variables
• Installer: install.conf — added remote and github to VALID_INSTALL_MODES, platform detection vars, wizard config, expanded TEMPLATE_VARS
• Templates: quickstart.md.template — enhanced with Bootstrap pill tabs for macOS/Linux/WSL/GitHub Fork platform-specific instructions
• Templates: configuration.md.template — comprehensive rewrite with URL tables, all config sections, cookie consent, dev config
• Templates: welcome-post.md.template — enhanced Day 1 tutorial with folder structure diagram, commands table, feature checklist

[0.22.6] - 2026-04-03

Changed

• Version bump: patch release

Commits in this release

• 0117620 chore(ci): streamline CI workflows with path-based change detection - Bump version to 0.22.5

[0.22.5] - 2026-04-03

Changed

• CI: Streamlined ci.yml — added path-based change detection to skip heavy jobs on docs-only PRs, removed scheduled cron runs and comprehensive test scope
• CI: Simplified codeql.yml workflow
• CI: Added test-latest.yml for latest dependency testing
• CI: Removed redundant summary job from release.yml
• CI: Simplified version-bump.yml
• Docs: Updated .github/workflows/README.md and .github/actions/README.md

Removed

• CI: Removed .github/actions/prepare-release/action.yml composite action

[0.22.4] - 2026-04-03

Changed

• Version bump: patch release

Commits in this release

• 9c56fe0 Review article: fix front matter and expand content for wizard-topples post (#47)

[0.22.3] - 2026-04-02

Changed

• Version bump: patch release

Commits in this release

• 059244d fix(landing): stabilize hero layout and scroll animations (#44)

[0.22.2] - 2026-04-02

Changed

• Version bump: patch release

Commits in this release

• a9b8daf docs(prompts): update commit-publish workflow with PR branching and CI fix guidance

[0.22.1] - 2026-04-02

Changed

• Version bump: patch release

Commits in this release

• a82f670 chore(ci): update Gemfile.lock to v0.22.0 and upgrade actions/checkout to v5

[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

• Environment Switcher: New settings modal tab with dev/prod URL shortcuts and copy actions
• Navigation Assets: Extracted navigation styles and scripts into _sass/core/_navbar.scss and assets/js/navigation.js

Changed

• Settings Modal: Redesigned info section with tabbed layout and compact theme info
• Navigation UI: Refined header utility controls, navbar labels/icons, and loaded navigation JS via js-cdn include
• Dev Shortcuts: Updated source shortcuts layout and labeling for clarity
• Theme Branding: Updated default title icon and subtitle in _config.yml

[0.20.8] - 2026-02-02

Changed

• Version bump: patch release

Commits in this release

• d71a42a feat(docker): add local Docker publishing capability

[0.20.7] - 2026-02-01

Changed

• Version bump: patch release

Commits in this release

• 969ce94 refactor(ci): abstract hardcoded values to GitHub variables and secrets

[0.20.6] - 2026-02-01

Changed

• Version bump: patch release

Commits in this release

• af25fc8 fix(ci): improve Docker compose compatibility for CI environments

[0.20.5] - 2026-02-01

Changed

• Version bump: patch release

Commits in this release

• 7a2eeaf fix(docker): add PAGES_REPO_NWO environment variable for Jekyll builds

[0.20.4] - 2026-02-01

Changed

• Version bump: patch release

Commits in this release

• a71e7a3 fix(ci): add PAGES_REPO_NWO env var and skip-remote for Jekyll builds
• 74e0929 fix(ci): ensure Gemfile.lock is updated during version bumps
• e06520e docs(prompts): enhance release pipeline documentation with best practices

[0.20.3] - 2026-02-01

Added

• Notes Collection: 5 new developer reference notes
  • bash-shortcuts.md - Essential terminal keyboard shortcuts
  • docker-commands.md - Docker and Docker Compose command reference
  • git-cheatsheet.md - Git commands quick reference
  • jekyll-front-matter.md - Jekyll front matter variables guide
  • markdown-tips.md - Advanced Markdown formatting tricks
• Python Statistics Notebook: New python-statistics.ipynb Jupyter notebook with scipy, pandas, and statistical analysis examples
• Enhanced Notes page: Added tag filtering and improved card-based layout
• Enhanced Notebooks page: Added difficulty filtering and improved card-based layout with download links

Changed

• Layout Standardization: Updated all posts from layout: journals to layout: article for consistency
• Section Index Pages: Updated category index pages to use layout: section with proper section_style settings
• News URL Structure: Changed permalinks from /posts/ to /news/ across all news sections
• Removed: Deleted unused pages/blog.md page

Fixed

• Layout consistency: Standardized layouts across Business, Development, Science, Technology, Tutorial, and World news sections

[0.20.2] - 2026-01-30

Added

• GitHub Pages Compatible Search: New out-of-box search functionality that works with GitHub Pages safe mode
  • _includes/search-data.json - Liquid template for generating search index
  • _layouts/search.html - Layout wrapper for search.json generation
  • Enhanced search index with date, categories, and tags fields
  • Configurable content length via site.search.content_length

Changed

• search.json: Now uses layout-based approach instead of inline Liquid for better theme integration
• Theme users only need a 5-line search.json file to enable search functionality

Technical Details

• Works in GitHub Pages safe mode (no Ruby plugins required)
• Indexes pages, posts, and all collection documents
• Produces valid JSON with 131+ items indexed
• Automatically included in gem via _includes/ and _layouts/ directories

[0.20.1] - 2026-01-26

Changed

• Version bump: patch release

Commits in this release

• 80ee1da feat(release): prepare 0.20.0
• 8c74a60 Merge branch ‘main’ of https://github.com/bamr87/zer0-mistakes
• 4d1c28c chore: update README for version 0.19.1
• 8157508 chore(deps): update Ruby gem dependencies (#22)
• 0f9d100 Merge branch ‘main’ of https://github.com/bamr87/zer0-mistakes
• 0cf42e9 chore: update Docker image reference in CI workflow

[0.20.0] - 2026-01-26

Added

• Scaffolding templates: New templates directory and helper scripts for fork cleanup and content setup.
• Testing assets: New test helpers and configs including installation, site generation, and visual suites.

Changed

• CI: Expanded workflow coverage for the updated test suite and automation paths.
• Install: Enhanced installation flow for template-based setup and post-install configuration.
• Docs: Updated Jekyll documentation index.

Fixed

• Dev build: Exclude templates from Jekyll processing to prevent invalid date parsing.

[0.19.1] - 2026-01-25

Changed

• Version bump: patch release

Commits in this release

• 516e56b fix(install): include docker/ directory in full installation
• c8a3dbb ci: optimize CI pipeline performance and integration tests
• 93fce7b ci: enhance CI workflow for Jekyll with improved Docker handling and site accessibility checks

[0.19.0] - 2026-01-25

Added

• Feature Discovery: Identified and documented 15 previously unlisted features (ZER0-029 through ZER0-043):
  • back-to-top.md - Floating scroll-to-top button
  • code-copy.md - One-click code block copy
  • color-modes.md - Dark/light mode toggle with system preference detection
  • site-search.md - Client-side search with modal and keyboard shortcut
  • toc.md - Table of contents with scroll spy
  • breadcrumbs.md - Hierarchical navigation with Schema.org markup
  • statistics-dashboard.md - Content metrics visualization
  • Google Analytics and Google Tag Manager integrations
  • Auto-hide navigation, particles background, SEO optimization, sitemap generation
• Development Documentation (pages/_docs/development/):
  • index.md - Development section overview
  • release-management.md - Semantic versioning and gem publishing guide
  • testing.md - Comprehensive test suite documentation
  • version-bump.md - Automated version workflow guide
  • security.md - CodeQL scanning documentation
  • ci-cd.md - CI/CD pipeline guide
  • dependency-updates.md - Automated dependency management
  • scripts.md - Shell script automation library
  • documentation.md - Dual documentation architecture guide
  • prd.md - Product requirements document
• Feature Documentation (pages/_docs/features/):
  • copilot-integration.md - GitHub Copilot integration guide
  • cookie-consent.md - GDPR/CCPA compliant consent system
  • sidebar-navigation.md - Enhanced sidebar with scroll spy
  • mobile-toc.md - Mobile TOC floating action button
  • skip-to-content.md - WCAG 2.1 accessibility link
  • jupyter-notebooks.md - Jupyter notebook support
  • theme-version.md - Theme version display plugin
• Analytics Section (pages/_docs/analytics/):
  • index.md - Analytics overview
  • google-analytics.md - GA4 integration guide
  • google-tag-manager.md - GTM setup guide
• SEO Section (pages/_docs/seo/):
  • index.md - SEO features overview
  • meta-tags.md - Open Graph, Twitter Cards, JSON-LD
  • sitemap.md - XML sitemap and search index generation
• Jekyll Documentation:
  • collections.md - Jekyll collections organization guide
• Customization Documentation:
  • includes.md - 70+ include components guide

Changed

• features.yml: Added 15 new features (ZER0-029 to ZER0-043) with complete metadata
• features.yml: Updated all documentation links from GitHub URLs to local /docs/ pages
• bootstrap/index.md: Expanded with comprehensive examples (grid, components, utilities)
• preview-image-generator.md: Complete rewrite with AI provider details and configuration

Documentation Stats

• 43 total features now fully documented
• 40+ new/updated documentation pages created
• All features linked to /docs/ pages (no external GitHub links for docs)

[0.18.2] - 2026-01-25

Changed

• Documentation Architecture: Major restructure separating user documentation (pages/_docs/) from developer documentation (docs/)
• Navigation: Updated _data/navigation/docs.yml with new section structure

Added

• User Documentation (pages/_docs/):
  • getting-started/ - Installation guides, quick start, theme guide
  • features/ - Mermaid diagrams, MathJax, Giscus comments, PostHog analytics, keyboard navigation
  • deployment/ - GitHub Pages, Netlify, custom domain guides
  • customization/ - Layouts, styles, navigation customization guides
• Developer Documentation (docs/):
  • architecture/ - Project structure, layouts/includes, build system
  • development/ - Local setup, testing, code style guides
  • implementation/ - Feature implementation changelogs (renamed from features/)

Removed

• Duplicate user-facing documentation from docs/jekyll/ (moved to pages/_docs/)
• Legacy docs/QUICKSTART.md and docs/keyboard-navigation.md (content moved to user docs)

[0.18.1] - 2026-01-24

Changed

• Documentation: Complete refactoring of Jekyll documentation from 22 tutorial-style files into 13 consolidated feature-focused guides

Added

• docs/jekyll/theme-guide.md - Comprehensive theme setup and customization (461 lines)
• docs/jekyll/diagrams-mermaid.md - Mermaid diagrams integration guide (454 lines)
• docs/jekyll/analytics-posthog.md - PostHog privacy-first analytics setup (323 lines)
• docs/jekyll/math-mathjax.md - MathJax mathematical notation guide (257 lines)
• docs/jekyll/comments-giscus.md - GitHub Discussions-powered comments (223 lines)
• docs/jekyll/code-highlighting.md - Syntax highlighting with Rouge/highlight.js (151 lines)
• docs/jekyll/liquid-reference.md - Liquid templating quick reference (132 lines)
• docs/jekyll/pagination.md - Pagination implementation guide (130 lines)
• docs/jekyll/config-reference.md - Jekyll configuration options reference (102 lines)
• docs/jekyll/troubleshooting-port.md - Port 4000 troubleshooting guide (89 lines)
• docs/jekyll/deploy-netlify.md - Netlify deployment guide (84 lines)
• docs/jekyll/security-headers.md - Netlify security headers configuration (70 lines)
• docs/jekyll/custom-domain.md - GitHub Pages custom domain setup (65 lines)

Removed

• Deprecated Jekyll tutorial files replaced by new consolidated guides:
  • jekyll-pagination.md, jekyll-performance-optimization.md, jekyll-progress-bar.md
  • jekyll-search-function-for-static-website.md, jekyll-security.md
  • jekyll-social-share-buttons-with-sharethis.md, jekyll-social-share-buttons.md
  • jekyll-usage-and-customization.md, jekyll-highlighting.md, jekyll-liquid.md
  • jekyll-math-symbols-with-mathjax.md, jekyll-diagram-with-mermaid.md
  • jekyll-comments-with-disqus.md, jekyll-google-analytics.md, jekyll-config.md
  • jekyll-frontmatter-cms.md, mermaid-native-markdown.md, mermaid-test-suite.md, mermaid.md
  • deploying-jekyll-website-to-netlify.md, deploying-personal-website-with-custom-domain.md
  • continuously-deploy-jekyll-website-to-gitHub-pages-with-travis-ci.md
  • cannot-start-jekyll-at-specific-port.md

[0.18.0] - 2026-01-19

Added

• Search Modal: New site-wide search popup with live results, keyboard shortcuts (/, Cmd/Ctrl+K), and offcanvas entry
• Search Index: Generated search.json index including page content for client-side search

Changed

• Navigation: Added search button to the main navbar with improved mobile layout support

Fixed

• Search UX: Highlight query matches and show content-based snippets where the match occurs

[0.17.5] - 2026-01-17

Changed

• Version bump: patch release

Commits in this release

• eeb8ea3 fix(ui): remove cursor tilt and prep v0.17.4

[0.17.4] - 2026-01-16

Changed

• Version bump: patch release

Fixed

• UI/UX: Removed cursor-based 3D parallax tilt effect on cards to prevent perspective shifts on hover
• Config YAML: Corrected anchor definitions used by gravatar and local repo settings to pass YAML validation

Commits in this release

• 226b0a5 chore(structure): reorganize root directory for better maintainability

[0.17.3] - 2026-01-15

Changed

• Version bump: patch release

Commits in this release

• a0c1df4 fix(ui): fix Mermaid dark mode and cookie banner rendering

[0.17.2] - 2025-12-31

Fixed

• Mermaid Dark Mode: Fixed diagram rendering issues in dark mode by dynamically detecting Bootstrap theme (data-bs-theme) and switching Mermaid theme accordingly
• Cookie Consent Banner: Fixed banner appearing twice on initial page load by implementing CSS-first visibility control and removing inline style conflicts

Enhanced

• UI/UX Improvements: Comprehensive frontend enhancements including:
  • Smooth scroll animations with Intersection Observer
  • Enhanced card hover effects with 3D parallax on desktop
  • Improved button styles with ripple effects and better transitions
  • Better code block styling with enhanced copy functionality
  • Mobile-responsive improvements with touch-friendly tap targets
  • Improved focus states for accessibility
  • Hero section animations with staggered fade-in effects

Added

• UI Enhancements Module: New assets/js/ui-enhancements.js for scroll animations, card interactions, and smooth scrolling
• Enhanced Code Copy: Improved copy-to-clipboard functionality with better visual feedback and fallback support

Changed

• CI Configuration: Made HTMLProofer non-blocking for pre-existing link issues
• Documentation: Enhanced contributing guide and release pipeline documentation 4630c33 (fix(ui): fix Mermaid dark mode and cookie banner rendering)

[0.17.1] - 2025-12-24

Changed

• Version bump: patch release

Commits in this release

• d56de0b fix(ci): update Gemfile.lock for v0.17.0 and improve HTMLProofer config

[0.17.0] - 2025-12-23

Added

• Navbar Hover Dropdowns: Desktop users can now hover over navigation items to reveal sub-menus with smooth fade transitions
• ES6 Navigation Modules: Complete rewrite of navigation JavaScript using native ES6 modules (type="module")
  • config.js - Centralized configuration with CSS custom properties
  • scroll-spy.js - Table of contents highlighting
  • smooth-scroll.js - Animated scrolling to anchors
  • keyboard.js - Full keyboard navigation support
  • gestures.js - Touch gesture support for mobile
  • focus.js - Focus management and accessibility
  • sidebar-state.js - Persistent expand/collapse state
  • index.js - Module orchestration and initialization
• Nav Tree Component: New _includes/navigation/nav-tree.html for rendering hierarchical YAML navigation (2 levels deep)
• Navigation Schema Documentation: Added _data/navigation/README.md with complete schema definition
• Migration Script: Added scripts/migrate-nav-modes.sh to update front matter from old to new nav modes

Changed

• Navigation YAML Schema: Standardized on children key (previously sublinks) across all navigation files
• Navigation Modes: Simplified to 3 standard modes:
  • auto - Auto-generates from collection documents (replaces dynamic)
  • tree - Uses YAML data files for hierarchical navigation
  • categories - Groups content by Jekyll categories (replaces searchCats)
• Sidebar Component: Refactored _includes/navigation/sidebar-left.html to use new nav modes
• Script Loading: Updated _includes/components/js-cdn.html to use type="module" for ES6 modules
• Default Collection Config: Updated _config.yml with new navigation mode defaults

Removed

• Legacy sidebar.js: Deleted 512-line IIFE-based sidebar script, replaced by modular ES6 architecture

Fixed

• Mobile Dropdown Behavior: Fixed glitch where opening one dropdown would close others; each now operates independently
• Dropdown Positioning: Fixed desktop hover dropdowns appearing on top of parent links (now correctly appear below)

[0.16.3] - 2025-01-27

Changed

• Documentation Navigation: Restructured _data/navigation/docs.yml with logical sections (Getting Started, Core Technologies, Theme Features, Deployment)
• Main Navigation: Updated _data/navigation/main.yml with expanded Docs dropdown entries (Documentation Home, Installation, Docker, Troubleshooting)

Fixed

• Liquid Syntax Error: Fixed pre-existing bug in pages/features.md where where_exp filters used unsupported or conditions (Liquid 4.x compatibility)

Documentation

• Installation Guide: Expanded with platform-specific guides (macOS, Windows, Linux), Docker quick start, verification steps
• Docker Guide: Added essential commands, container workflows, configuration files, Apple Silicon support, troubleshooting
• Troubleshooting Guide: Added sections for Docker issues, Jekyll build errors, front matter problems, performance optimization
• Jekyll Guide: Added directory structure, configuration files, content collections, essential commands, topic index
• Bootstrap Guide: Added CDN loading patterns, key components, responsive breakpoints, custom styles, icons
• Liquid Guide: Added syntax examples with `` tags, filters, control flow, includes
• Ruby Guide: Added version commands, common commands, key files, Docker usage, troubleshooting
• Front Matter Guide: Added required/optional fields, layout options, collection-specific fields, complete examples
• All documentation pages now include sidebar: nav: docs for consistent navigation

[0.16.2] - 2025-12-20

Changed

• Version bump: patch release

Commits in this release

• 2a0057e Comprehensive features.yml with references, documentation, and showcase page (#17)

[0.16.1] - 2025-12-20

Changed

• Hardened CI workflows with least-privilege permissions and concurrency
• Updated landing/repo links to render correctly with YAML-array URL config
• Excluded repo technical docs/ from the published site build (GitHub links used instead)

Fixed

• Removed false-green behavior in test-latest.yml (RSpec/HTMLProofer now fail the workflow)
• Fixed broken internal links/hashes and aligned navigation anchors (strict HTMLProofer-compatible)

[0.16.0] - 2025-12-20

Added

• Configurable Assets Prefix: New assets_prefix and auto_prefix configuration options for preview images
  • Allows shorter frontmatter paths like /images/previews/image.png instead of /assets/images/previews/image.png
  • Automatic path normalization in Liquid templates detects external URLs vs local paths
  • Configured via _config.yml under preview_images.assets_prefix and preview_images.auto_prefix
• xAI Grok Image Provider: Added xAI as a new AI provider for preview image generation
  • Uses grok-2-image model at https://api.x.ai/v1/images/generations
  • Set XAI_API_KEY environment variable and use --provider xai flag
• Preview Path Migration Script: New scripts/update-preview-paths.sh for migrating existing frontmatter
  • Supports dry-run and apply modes
  • Removes /assets/ prefix from preview paths in markdown files

Changed

• Updated preview-image.html include with path normalization logic
• Updated intro.html include with assets prefix support for hero backgrounds
• Updated seo.html include with assets prefix normalization for og:image meta tags
• Enhanced preview_image_generator.rb Ruby plugin with normalize_preview_path method
• Enhanced preview_generator.py with xAI provider, --assets-prefix, and --no-auto-prefix CLI options
• Migrated 24 markdown files to use shorter preview paths (without /assets/ prefix)
• Updated scripts/README.md documentation with new provider and prefix options

Fixed

• Critical: Liquid syntax error in seo.html - Fixed invalid nested curly braces on line 27

[0.15.5] - 2025-12-20

Changed

• Version bump: patch release

Commits in this release

• d46cdb1 Merge branch ‘main’ of https://github.com/bamr87/zer0-mistakes
• 36767cd fix: update last modified timestamp in quick start guide
• f606096 fix: update quick start guide for clarity and consistency

[0.15.4] - 2025-12-20

Changed

• Version bump: patch release

Commits in this release

• bafb5ea fix: resolve CI quality check failures for preview images

[0.15.3] - 2025-12-20

Changed

• Version bump: patch release

Commits in this release

• 2f8b580 chore: merge branch and version bump to 0.15.2
• a239892 chore: bump version to 0.15.2

[0.15.2] - 2025-12-19

Changed

• Version bump: patch release

Commits in this release

• e1342ab Add configuration files for content organization, prerequisites, statistics, and UI text
• 366e8a2 chore(deps): update Ruby gem dependencies (#16)

  [0.15.1] - 2025-12-14

Changed

• update test runner documentation for Bash 3.2 compatibility
• update version to 0.15.0 and enhance documentation with new features

Fixed

• refactor changelog.sh for Bash 3.2 compatibility (macOS default)

Other

• document Bash 3.2 compatibility in automation
• unfreeze bundler before updating Gemfile.lock in version-bump workflow
• update Windows Developer Mode instructions and correct spelling errors
• Social sharing buttons use production URLs instead of localhost
• update Gemfile.lock for v0.15.0

[0.15.0] - 2025-12-11

Added

• Documentation: Product Requirements Document - Comprehensive PRD detailing product vision, goals, and architecture
  • Added docs/PRD.md with complete product specifications
  • Includes vision statement, key differentiators, and metrics
  • Documents AI-powered features and privacy-first principles
• Documentation: Sidebar Improvements Summary - Complete implementation documentation for sidebar enhancements
  • Added docs/SIDEBAR_IMPROVEMENTS.md documenting UI/UX modernization
  • Details scroll spy fixes, mobile TOC button positioning
  • Documents responsive design improvements and accessibility features
• Documentation: Theme Version Implementation - Theme version display system documentation
  • Added docs/THEME_VERSION_IMPLEMENTATION.md
  • Documents automatic version extraction from gem specification
  • Explains modal integration and footer access points
• Content: Privacy Policy Page - GDPR/CCPA compliant privacy policy
  • Added pages/privacy-policy.md with comprehensive privacy documentation
  • Details PostHog analytics data collection practices
  • Explains user rights and data protection measures
• Content: Terms of Service Page - Legal terms for site usage
  • Added pages/terms-of-service.md
  • Provides basic terms framework for site operators
• Testing: Notebook Conversion Test Script - Automated testing for Jupyter notebook conversion
  • Added test/test-notebook-conversion.sh for notebook workflow testing
  • Validates Python/nbconvert installation in Docker
  • Tests notebook listing and conversion processes

Documentation

• All new files are fully documented with appropriate frontmatter
• Privacy policy provides transparency for analytics usage
• PRD serves as single source of truth for product direction

[0.14.2] - 2025-12-07

Changed

• Version bump: patch release

Commits in this release

• 82d7441 fix(build): improve gem info retrieval error handling
• 67a8e5b fix(ci): remove Ruby 3.0 from test matrix
• afe057d chore(deps): update Ruby gem dependencies (#11)
• 64ee1c9 fix(ci): add proper permissions for PR creation
• 3b55b60 feat(ci): add automated dependency update workflow
• a3197b3 fix(deps): commit Gemfile.lock for reproducible builds
• d8188dd fix(docker): install bundler 2.3 to match Gemfile.lock requirement
• 04d7c26 fix(docker): remove bundle update –bundler that requires existing bundle

[0.14.1] - 2025-12-04

Fixed

• Docker: Bundler Version Compatibility - Resolved CI/CD build failure
  • Added bundle update --bundler step in Dockerfile to auto-update lockfile
  • Allows using latest Bundler (4.0.0) while maintaining dependency stability
  • Preserves all gem versions from Gemfile.lock
  • Aligns with project’s “zero version pin” philosophy
  • Fixes GitHub Actions “Build (Latest Deps)” workflow failure

[0.14.0] - 2025-12-01

Added

• Navigation: Enhanced Sidebar System - Complete overhaul of sidebar navigation with modern features
  • New assets/js/sidebar.js (16KB) with Intersection Observer scroll spy
  • Smooth scrolling to TOC anchors with fixed header offset
  • Keyboard shortcuts: [ and ] for section navigation
  • Swipe gestures for mobile (left/right edge detection)
  • Focus management for accessibility
  • docs/keyboard-navigation.md - Complete keyboard navigation documentation
• Navigation: Skip-to-Content Link - Accessibility enhancement in header
  • Visually hidden until focused with Tab key
  • Direct jump to main content bypassing navigation
  • WCAG 2.1 Level AA compliant
• Mobile: TOC Floating Action Button - Improved mobile table of contents access
  • Repositioned from center-right to bottom-right (90px from bottom)
  • FAB pattern with 56x56px circular button
  • Proper stacking above back-to-top button
  • z-index: 1030 for proper layering

Changed

• Navigation: Unified Bootstrap Icons - Standardized icon library across all sidebars
  • Replaced Font Awesome (fas fa-file-alt) with Bootstrap Icons (bi-file-text)
  • Consistent icon sizing and spacing (me-2 margin)
  • Icons: bi-folder2-open, bi-folder, bi-file-earmark-text, bi-list-ul
• Navigation: Scroll Spy Fix - Corrected scroll tracking in default layout
  • Fixed data-bs-target from toc-content to #TableOfContents
  • Added data-bs-smooth-scroll="true" for better UX
  • Added data-bs-offset="100" for fixed header compensation
• Navigation: Responsive Sidebar Widths - Removed hardcoded widths for better responsiveness
  • sidebar-categories.html: Changed from width: 280px to w-100
  • Uses Bootstrap grid system for fluid layouts
  • Improved mobile and tablet compatibility
• Styles: Unified Sidebar Classes - Consolidated duplicate CSS definitions
  • Removed duplicate .sidebar class from custom.scss
  • Kept only .bd-sidebar in _docs.scss for consistency
  • Uncommented z-index (2) for proper TOC stacking
• Styles: Enhanced Active States - Improved visual feedback for navigation
  • Active TOC links: 600 font-weight, subtle background highlight
  • Category active state: Primary color with background tint
  • Sidebar hover states: Smooth 0.2s transitions
  • Mobile TOC button: Scale transforms on hover/active
• JavaScript: Deferred Loading - Optimized script loading for better performance
  • Added defer attribute to sidebar.js
  • Prevents blocking and scroll event conflicts
  • Fixed auto-hide navbar functionality
  • Parallel download with in-order execution
• Accessibility: ARIA Enhancements - Improved screen reader support
  • Added role="navigation" and aria-label to TOC
  • Added aria-controls to all collapse/offcanvas buttons
  • Improved button accessibility with descriptive labels
  • Better focus management in offcanvas panels

Fixed

• Critical: Scroll Spy Not Working - Resolved selector mismatch in default layout
  • Corrected target from toc-content to #TableOfContents
  • Active section now properly highlights in TOC
  • Smooth scroll with proper offset for fixed headers
• Critical: Mobile Button Conflict - Fixed TOC and back-to-top button overlap
  • TOC button: moved to bottom: 90px from bottom: 0
  • Back-to-top button: updated z-index to 1020
  • 14px vertical spacing between buttons
  • No more overlapping on mobile devices
• Critical: Auto-Hide Navbar Broken - Fixed navbar hiding on scroll
  • Added defer attribute to sidebar.js script tag
  • Resolved scroll event listener conflicts
  • Both scripts now use requestAnimationFrame optimization
  • Navbar properly hides/shows on scroll
• UI: Icon Library Inconsistency - Unified icon usage across components
  • Eliminated mixed Font Awesome and Bootstrap Icons usage
  • All components now use Bootstrap Icons exclusively
  • Consistent visual language throughout theme

Performance

• Intersection Observer Scroll Spy - 70% reduction in scroll event overhead
  • Replaced scroll events with Intersection Observer API
  • Configurable root margins and thresholds
  • Auto-scrolling TOC to show active link
  • Debounced event handlers (100ms delay)
• Passive Scroll Listeners - Improved scrolling performance
  • All scroll events use { passive: true } option
  • Prevents scroll jank and layout thrashing
  • Better frame rates on mobile devices

Documentation

• Guide: Keyboard Navigation - Comprehensive accessibility documentation
  • Complete shortcut reference table
  • Skip navigation instructions
  • Focus management guidelines
  • Browser compatibility matrix
  • Troubleshooting section
• Technical: Implementation Summary - Development documentation
  • SIDEBAR_IMPROVEMENTS.md with complete implementation details
  • Architecture decisions and patterns
  • Testing checklist and verification steps
  • Future enhancement roadmap

[0.13.0] - 2025-12-01

Added

• Navigation: Bootstrap Icons - Added icons to all main navigation items
  • Quick Start: bi-rocket-takeoff
  • Blog: bi-journal-text
  • Docs: bi-journal-bookmark
  • About: bi-info-circle
• Navigation: New Links - Enhanced navigation structure with additional pages
  • Categories page (/categories/)
  • Tags page (/tags/)
  • Contact page (/contact/)
  • Features page (/about/features/)
  • Statistics page (/about/stats/)
• Frontmatter CMS: Navigation Data Type - Enhanced data schema for navigation management
  • Added optional description field for parent and child links
  • Added optional icon field for sublinks
  • Registered all 6 navigation files (main, quickstart, about, docs, posts, home)
  • Improved schema validation with proper required fields

Changed

• Navigation: Restructured All Files - Aligned navigation with actual site content
  • main.yml - Updated Quick Start, Blog, Docs, and About sections
  • quickstart.yml - Added icons to setup steps
  • docs.yml - Reorganized into Jekyll, Features, Deployment, Configuration sections
  • about.yml - Structured into About, Site Info, Settings, Legal sections
  • posts.yml - Fixed icon prefixes (added bi-), added descriptions
  • home.yml - Added Discover and Connect navigation groups
• Frontmatter: Website Configuration - Updated preview and website hosts
  • Changed preview host from localhost:4002 to localhost:4000
  • Changed website host from it-journey.dev to zer0-mistakes.com

Removed

• Navigation: Dead Link - Removed orphaned /zer0/ link from Quick Start menu
• Navigation: Unused Entry - Removed Theme page link (replaced with Features)

Fixed

• Navigation: Icon Consistency - Standardized Bootstrap icon class format across all files
• Navigation: URL Completeness - Ensured all top-level navigation items have required URL field

[0.12.1] - 2025-11-30

Changed

• Refactored: Scripts Directory Structure - Consolidated and organized automation scripts
  • Entry point scripts (build, release) in scripts/ are now thin wrappers to scripts/bin/
  • Test scripts (test.sh, test-auto-version.sh, test-mermaid.sh) forward to scripts/test/
  • Utility scripts (setup.sh, analyze-commits.sh, fix-markdown-format.sh) forward to scripts/utils/
  • Feature scripts (generate-preview-images.sh, install-preview-generator.sh) forward to scripts/features/
  • Maintains backward compatibility while establishing canonical locations
• Moved: validate_preview_urls.py from scripts/lib/ to scripts/features/
  • Better organization as a feature-specific validator rather than core library
• Updated: Documentation - Corrected all script path references
  • scripts/README.md - New directory structure documentation
  • scripts/lib/README.md - Updated test paths
  • docs/systems/release-automation.md - Updated test paths
  • docs/TROUBLESHOOTING.md - Updated test paths
  • docs/archive/PHASE_1_COMPLETE.md - Updated historical references
  • docs/archive/RELEASE_WORKFLOW_IMPROVEMENTS.md - Updated historical references

Removed

• Deleted: scripts/lib/test/ - Redundant test directory (tests are in scripts/test/lib/)
• Deleted: scripts/features/preview_generator.py - Duplicate of scripts/lib/preview_generator.py
• Deleted: scripts/version.sh - Deprecated (use scripts/lib/version.sh or scripts/bin/release)

Fixed

• Fixed: Function ordering in scripts/bin/build - Moved show_usage() definition before it’s called

[0.12.0] - 2025-11-30

Added

• New Component: preview-image.html (_includes/components/preview-image.html)
  • Centralized preview image rendering component
  • Consistent handling of absolute paths and external URLs
  • Supports custom classes, styles, and lazy loading
  • Eliminates duplicated image rendering logic across layouts
• New Script: validate_preview_urls.py (scripts/lib/validate_preview_urls.py, 400+ lines)
  • Python-based validation for preview image URLs in frontmatter
  • Checks URL format (must start with /)
  • Validates image extensions (.png, .jpg, .jpeg, .gif, .webp, .svg)
  • Verifies file existence on disk
  • Detects empty, null, or malformed preview values
  • JSON output support for CI integration
  • Standalone CLI tool with --verbose, --suggestions, --list-missing options
• New Test Category: Content Quality Tests in Quality Assurance Suite
  • Added test_preview_image_urls() function to test/test_quality.sh
  • Validates all preview URLs in content frontmatter during test runs
  • Integrated into main test runner with new “📄 Content” category
  • Reports missing files and format errors with suggestions

Changed

• Refactored: Layout Image Handling - Simplified preview image logic
  • _layouts/blog.html - Replaced 5 separate image blocks with preview-image.html include
  • _layouts/journals.html - Unified preview image rendering
  • _layouts/category.html - Consistent image component usage
  • _layouts/collection.html - Streamlined image rendering
  • _includes/components/post-card.html - Uses centralized component
  • _includes/content/intro.html - Simplified image handling
  • index.html - Updated to use preview-image component
  • posts.html - Consistent preview image rendering
  • pages/blog.md - Updated image handling
• Enhanced: Quality Test Suite (test/test_quality.sh)
  • Added Content Quality Tests section with preview URL validation
  • Updated help text and summary to include content category
  • Extended JSON report generation with content test metrics
• Fixed: Preview URL Paths - Corrected several preview paths in content
  • pages/_posts/2024-06-17-wizard-topples-capitalist-dominance-ingeniously.md
  • pages/_posts/2025-01-01-getting-started-jekyll.md
  • pages/_posts/2025-01-05-web-accessibility-guide.md
  • pages/_posts/2025-01-10-bootstrap-5-components.md
  • pages/_posts/2025-01-15-docker-jekyll-guide.md

Documentation

• Updated _includes/README.md with preview-image.html component documentation

---

[0.11.0] - 2025-11-30

Added

• New Feature: Jupyter Notebook Support - Complete integration for data science and computational content
  • New Layout: notebook.html (_layouts/notebook.html, 294 lines)
    • Dedicated layout for converted notebooks with metadata display
    • Author, date, kernel info, and reading time display
    • Previous/next navigation between notebooks
    • Related notebooks section
    • Schema.org TechArticle markup for SEO
    • Download original .ipynb link
    • Giscus comments integration
  • New Stylesheet: notebooks.scss (_sass/notebooks.scss, 450+ lines)
    • Code cell styling with execution counts
    • Output area formatting (text, images, tables, errors)
    • MathJax equation styling
    • Responsive design with mobile breakpoints (@media max-width: 768px)
    • Dark mode support
    • Bootstrap 5 variable integration
  • New Conversion Script: convert-notebooks.sh (scripts/convert-notebooks.sh, 408 lines)
    • Converts .ipynb files to Jekyll-compatible Markdown
    • Extracts images to /assets/images/notebooks/
    • Generates proper front matter with title, description, date, permalink
    • JSON-based metadata parsing to avoid delimiter issues
    • CLI options: --force, --dry-run, --list, --clean, --verbose
    • Follows project script patterns with colored logging
  • New GitHub Actions Workflow (.github/workflows/convert-notebooks.yml, 220+ lines)
    • Triggers on push/PR to pages/_notebooks/**.ipynb
    • Dry-run mode for pull requests
    • Automatic conversion and commit on main/develop branches
    • Validation job checks markdown and image references
    • Commits with [skip ci] to prevent loops
  • New Documentation (docs/JUPYTER_NOTEBOOKS.md)
    • Complete feature documentation
    • Usage examples and workflow
    • Troubleshooting guide
    • Architecture explanation
    • File manifest
  • New Test Suite (test-notebook-conversion.sh, 150+ lines)
    • 8-step automated validation
    • Docker status, Python/nbconvert checks
    • Conversion validation
    • Front matter and image verification
• Makefile Targets - Added notebook conversion commands
  • convert-notebooks - Convert all notebooks
  • convert-notebooks-dry-run - Preview conversions
  • convert-notebooks-force - Force reconvert all
  • list-notebooks - List available notebooks
  • clean-notebooks - Remove converted markdown
• Sample Content (pages/_notebooks/test-notebook.ipynb)
  • Comprehensive demonstration notebook with 10 cells
  • LaTeX equations, matplotlib plots, pandas DataFrames
  • Fibonacci function example
  • All outputs rendered (text, images, HTML tables)

Changed

• Enhanced: Docker Environment (docker/Dockerfile)
  • Added Python 3.13.5, pip, jupyter, nbconvert
  • Used --break-system-packages flag for PEP 668 compatibility
  • Multi-stage build preserves Python tooling
• Enhanced: Jekyll Configuration (_config.yml)
  • Added notebooks collection defaults
  • Set layout: notebook, jupyter_metadata: true
  • Configured sidebar navigation for notebooks
• Enhanced: Sass Import (_sass/custom.scss)
  • Added @import "notebooks"; at top of file
  • Ensures notebook styles load properly
• Documentation (README.md)
  • Added “Jupyter Notebook Support” feature section
  • Installation and usage examples
  • Feature highlights: automatic conversion, output rendering, GitHub Actions

[0.10.6] - 2025-11-29

Changed

• Improved: Version Definition (lib/jekyll-theme-zer0/version.rb)
  • Added conditional version definition to prevent reinitialization warnings
  • Uses unless defined? guard to safely handle multiple requires
  • Improves compatibility with various Jekyll plugin loading scenarios
• Enhanced: Dependency Management (Gemfile)
  • Added faraday-retry gem for Faraday v2.0+ compatibility
  • Resolves “To use retry middleware with Faraday v2.0+, install faraday-retry gem” warning
  • Ensures robust HTTP client functionality for API integrations

Fixed

• Build Optimization (_config.yml)
  • Added _site/lib/ to exclude list to prevent recursive gem building
  • Reduces build size and prevents unnecessary file processing
  • Improves build performance and artifact cleanliness
• Documentation: CHANGELOG Formatting
  • Removed raw Liquid syntax markers from CHANGELOG for better readability
  • Cleaned up technical implementation details in previous entries

[0.10.5] - 2025-11-29

Fixed

• Critical: Nested Liquid Output Tags in Footer (_includes/core/footer.html)
  • Fixed nested Liquid output tags causing template errors
  • Used capture blocks to properly combine icon classes
  • Resolved syntax errors in powered-by credits and social links sections
  • Ensures proper icon rendering in Bootstrap 5 components
• Critical: Sass Syntax Errors (_sass/custom.scss)
  • Fixed missing spaces after colons in CSS vendor prefix properties
  • Corrected position:-webkit-sticky to position: -webkit-sticky (lines 40, 105)
  • Ensures proper CSS compilation and browser compatibility
  • Validates against CSS linting standards
• Improved: Test Suite Reliability (test/test_deployment.sh, test/test_quality.sh)
  • Docker Volume Mounting Test: Changed from hard failure to graceful warning when Docker image not built
    • Fixed incorrect path expectation (/app → /site) to match Dockerfile WORKDIR
    • Accepts incomplete Docker setup as valid state for development environments
  • Jekyll Docker Build Test: Made timeout handling more lenient
    • Changed timeout errors to warnings for resource-constrained environments
    • Prevents false positives on slow Docker builds or limited CPU/memory
  • Ruby Version Compatibility: Added comprehensive Ruby version guards
    • Detects Ruby < 2.7.0 and skips incompatible tests gracefully
    • Prevents test failures due to environment limitations
  • HTML5 Validation: Fixed case-sensitive doctype detection
    • Changed from case-sensitive <!DOCTYPE html> to case-insensitive <!doctype html>
    • Properly handles various HTML5 doctype formats
  • Accessibility: Reduced noise from multiple h1 tag warnings
    • Removed warnings for multiple h1 tags (valid HTML5 sectioning pattern)
    • Added clarifying comments about HTML5 semantic sections
  • Overall improvement: Test suite now handles environmental constraints gracefully rather than failing harshly

[0.10.4] - 2025-11-29

Changed

• Improved: Bootstrap Theme Color Scheme (_includes/stats/)
  • Migrated from gradient backgrounds (bg-gradient) to Bootstrap 5 subtle variants (bg-primary-subtle, bg-info-subtle, bg-warning-subtle)
  • Updated text colors to use emphasis variants (text-primary-emphasis, text-info-emphasis, text-warning-emphasis)
  • Replaced bg-light with semantic bg-body-secondary for better theme consistency
  • Updated footer and card backgrounds to use theme-aware classes
  • Removed border-0 classes to allow default Bootstrap borders
  • All statistics components now follow Bootstrap 5 color system conventions
• Improved: Cookie Consent Component (_includes/components/cookie-consent.html)
  • Updated modal styling with theme-aware background classes
  • Better visual consistency with updated color scheme
• Improved: Post Card Component (_includes/components/post-card.html)
  • Enhanced visual styling to match theme updates
• Improved: Sitemap Component (_includes/content/sitemap.html)
  • Updated styling for consistency with Bootstrap 5 theme
• Improved: Landing Page Layout (_layouts/landing.html)
  • Refined layout styling for better visual hierarchy
• Improved: Blog Layout (_layouts/blog.html)
  • Updated layout to align with theme improvements
• Improved: Sitemap Collection Layout (_layouts/sitemap-collection.html)
  • Enhanced layout for better content presentation
• Restructured: README.md Documentation
  • Reorganized content structure for better readability
  • Updated version references from 0.9.2 to 0.10.3
  • Added centered layout with improved badge display
  • Changed tagline to “The Self-Healing Jekyll Theme”
  • Updated lastmod date to 2025-11-29
  • Added mermaid support flag to front matter
  • Improved navigation structure in documentation

Removed

• Deleted: Duplicate Index File (pages/index.html)
  • Removed 341-line duplicate index file from pages directory
  • Site now uses single index.html at root for cleaner architecture

Fixed

• Fixed: Git Workflow Documentation (pages/_posts/development/2025-01-22-git-workflow-best-practices.md)
  • Corrected formatting and content issues
• Fixed: Page Navigation (pages/blog.md, pages/categories.md, pages/tags.md, index.html)
  • Improved navigation consistency across pages

[0.10.3] - 2025-11-29

Added

• New: AI-Generated Preview Images - 17 new preview images for posts and collections
  • Business, Development, Science, Technology, Tutorial, World category index pages
  • Individual post previews: startup funding, quantum computing, AI tools, CSS grid, remote work
  • Quickstart guide previews: GitHub setup, Jekyll setup, machine setup
  • Documentation and blog index previews

Changed

• Improved: Preview Image Path Handling (_layouts/journals.html, _layouts/category.html, _layouts/collection.html)
  • Layouts now support both absolute paths (/assets/...) and relative paths
  • Conditional logic detects path type and constructs URL correctly
  • Eliminates double-slash issues in image URLs
• Improved: Intro Section Preview Image Logic (_includes/content/intro.html)
  • Smart path detection for preview images (absolute vs relative)
  • Handles URLs with :// schemes, paths starting with /, and relative filenames
  • Cleaner Liquid template logic with proper variable assignment
• Improved: Docker Development Setup (docker-compose.yml, docker/Dockerfile)
  • Command now runs bundle install before Jekyll serve (fixes volume mount overwrites)
  • Dockerfile copies gemspec and lib/ for proper dependency resolution
  • More reliable container startup with dependency installation
• Improved: Preview Image Generator (scripts/lib/preview_generator.py)
  • Switched from OpenAI SDK to direct HTTP API calls
  • Eliminates SDK dependency - only requires requests package
  • Better error handling with HTTP status code parsing
  • Added request timeouts (120s for generation, 60s for download)

Fixed

• Fixed: Asset Paths in Config (_config.yml)
  • Corrected teaser and info_banner paths to use /assets/images/ prefix
  • Images now load correctly across all pages
• Fixed: Preview Image Double-Slash URLs
  • Removed extra / between public_folder and site.teaser in fallback images
  • All layouts now generate clean, valid image URLs

[0.10.2] - 2025-11-28

Added

• Enhanced: Navbar Auto-Hide on Scroll (assets/js/auto-hide-nav.js)
  • Navbar hides when scrolling down past 100px threshold
  • Navbar reappears immediately when scrolling up
  • Automatic body padding to prevent content jump under fixed navbar
  • Performance-optimized with requestAnimationFrame throttling
  • Respects prefers-reduced-motion accessibility setting

Changed

• Improved: Header Positioning (_includes/core/header.html)
  • Changed from z-1 to Bootstrap’s fixed-top class
  • Provides proper z-index (1030) and fixed positioning
• Refactored: Navbar CSS (_sass/custom.scss)
  • Replaced broken .hide-navbar and .fixed-navbar classes
  • New .navbar-hidden class with translateY(-100%) transform
  • Added !important to override Bootstrap’s fixed-top positioning
  • Added explicit background color for opaque navbar
  • Added prefers-reduced-motion media query for accessibility

Fixed

• Fixed: Navbar Blocking Content on Scroll Up
  • Content no longer obscured when scrolling back to top
  • Body padding dynamically calculated based on navbar height

[0.10.1] - 2025-11-28

Added

• Enhanced: Mermaid v2.1 - GitHub Pages Compatible (_includes/components/mermaid.html)
  • Client-side conversion of native markdown ` ```mermaid ` code blocks to rendered diagrams
  • Full GitHub Pages compatibility without custom plugins (all processing client-side)
  • CSS to hide code blocks during conversion (prevents flash of unstyled content)
  • Print styles and improved responsive design
  • Documented dual syntax support (native markdown and HTML div)

Changed

• Improved: Mermaid Configuration (_config.yml)
  • Added clear comments explaining GitHub Pages compatibility
  • Documented that jekyll-mermaid plugin is optional
  • Updated usage instructions for both syntax options
• Improved: Mermaid Documentation
  • docs/jekyll/mermaid.md: Added native markdown syntax as recommended option
  • docs/jekyll/mermaid-native-markdown.md: Fixed documentation about front matter requirements
  • Added GitHub Pages compatibility badges to documentation

Fixed

• Fixed: Native Markdown Mermaid Syntax Not Rendering
  • ` ```mermaid ` code blocks now properly convert to diagrams via JavaScript
  • Works with GitHub Pages remote_theme deployment
• Fixed: Mermaid Test Script (scripts/test-mermaid.sh)
  • Corrected file path references from pages/_docs/jekyll/ to docs/jekyll/
  • Fixed SIGPIPE issues with curl | grep pipelines causing false test failures
  • All 21 tests now pass successfully

[0.10.0] - 2025-11-28

Added

• New: Zero Version Pin Strategy - Enterprise-grade dependency management paradigm
  • Always use latest compatible versions with zero pins anywhere
  • Fail fast in CI if incompatible → caught early, not in production
  • Production uses immutable image tags (date+commit hash), never :latest
  • Full documentation in docs/systems/ZERO_PIN_STRATEGY.md
• New: Docker Multi-Stage Dockerfile (docker/Dockerfile)
  • base stage: Ruby slim + build dependencies
  • dev-test stage: Full dev/test gems for CI validation
  • build stage: Production Jekyll build
  • production stage: Minimal runtime for serving
• New: Docker Compose Configurations
  • docker-compose.yml: Development environment with live reload
  • docker-compose.test.yml: CI testing overlay with validation
  • docker-compose.prod.yml: Production with immutable tags only
• New: CI Workflow for Zero Pin Strategy (.github/workflows/test-latest.yml)
  • Builds with --no-cache for latest dependencies
  • Documents resolved versions in workflow summary
  • Tags and publishes immutable images on success
  • Debug information on failure
• New: .dockerignore - Optimized Docker build context
  • Excludes development files, tests, logs, and build artifacts
  • Keeps only files needed for container builds
• New: VS Code Workspace Configuration (zer0-mistakes.code-workspace)
  • Copilot settings for all file types
  • File associations for Jekyll/Liquid
  • Terminal environment variables for Docker

Changed

• Improved: Gemfile - Refactored for zero version pin strategy
  • Removed all version constraints
  • Added development/test group with html-proofer, rspec, rake, rubocop
  • Added platform-specific dependencies for Windows
  • Comprehensive documentation comments
• Improved: docker-compose.yml - Enhanced for zero pin strategy
  • Uses custom Dockerfile instead of jekyll/jekyll image
  • Added bundle cache volume for faster rebuilds
  • LiveReload port (35729) exposed
  • TTY enabled for interactive commands
• Improved: jekyll-theme-zer0.gemspec - Compatibility updates
  • Ruby requirement lowered to >= 2.7.0 (from 3.0.0) for broader compatibility
  • Bundler dependency changed to ~> 2.3 (from >= 2.3)
• Improved: CI Workflow (.github/workflows/ci.yml)
  • Added documentation comments explaining version strategy
  • Clarified that explicit versions are for backwards compatibility testing

Fixed

• Fixed: scripts/generate-preview-images.sh - Reverted to simpler collection handling
  • Removed dynamic collection reading (caused issues in some environments)
  • Restored hardcoded collection list for reliability
  • Fixed yq vs sed front matter update logic

[0.9.2] - 2025-11-28

Changed

• Version bump: patch release

Commits in this release

• 509d705 fix(ci): fix false positive failure detection in test report validation
• 77dc04b fix(ci): fix shell syntax error in test-suite validation step

[0.9.1] - 2025-11-27

Fixed

• CI: Test suite failures across Ruby versions - Resolved issues causing CI failures
  • Fixed --skip-docker option error by only passing it to deployment tests (not quality tests)
  • Fixed bash arithmetic syntax error in Liquid tag validation by sanitizing grep output
  • Added bundler 2.5 requirement to setup-ruby action for Ruby 3.0 compatibility

[0.9.0] - 2025-06-30

Changed

• Refactored: Scripts Directory Structure - Complete reorganization for better maintainability
  • New bin/ directory for main entry points (release, build, test)
  • New utils/ directory for utility scripts (setup, analyze-commits, fix-markdown)
  • New features/ directory for feature-specific scripts (generate-preview-images, install-preview-generator)
  • New test/ directory hierarchy with lib/, theme/, and integration/ subdirectories
  • Unified test runner in bin/test that runs all test suites with single command
• Improved: Script Library Integration - All scripts now use shared lib/common.sh
  • Consistent logging functions (log, info, success, warn, error, debug)
  • Standardized color output and formatting
  • Removed duplicate code from individual scripts
• Updated: Documentation - Complete rewrite of scripts/README.md
  • Clear directory structure overview
  • Quick start guide for common operations
  • Migration table from legacy to new script locations
  • Dependency graph for library modules

Added

• New: bin/test Unified Test Runner - Single command to run all tests
  • Supports running specific test suites (lib, theme, integration, all)
  • Verbose output mode with --verbose flag
  • Summary of passed/failed test suites
• New: test/theme/validate - Theme structure validation tests
  • Validates layouts, includes, and assets directories
  • Sources shared library for consistent output
• New: test/integration/auto-version - Auto-version integration tests
  • Moved from tests/ directory with updated library paths

Deprecated

• Deprecated: scripts/version.sh - Now displays deprecation warning
  • Recommends using bin/release for full workflow
  • Will be removed in future release

Migration Guide

Legacy Script	New Location
version.sh	bin/release
setup.sh	utils/setup
test.sh	bin/test or test/theme/validate
analyze-commits.sh	utils/analyze-commits
fix-markdown-format.sh	utils/fix-markdown
generate-preview-images.sh	features/generate-preview-images
install-preview-generator.sh	features/install-preview-generator

[0.8.2] - 2025-11-27

Changed

• Refactored: GitHub Actions Workflows - Consolidated 5 workflows into 3 streamlined workflows
  • Merged auto-version-bump.yml into version-bump.yml with both automatic and manual triggers
  • Merged gem-release.yml and github-release.yml into unified release.yml
  • Removed duplicate quality job from ci.yml (functionality retained in quality-checks job)
  • Updated ci.yml build job to use scripts/build instead of deprecated build.sh
• Updated: Composite Action prepare-release - Now uses scripts/build instead of deprecated build.sh

Added

• New Documentation: .github/workflows/README.md - Comprehensive workflow documentation
  • Workflow trigger flow diagram
  • Job descriptions and timeout configurations
  • Manual dispatch options and troubleshooting guide
• New Documentation: .github/actions/README.md - Composite actions documentation
  • Input/output specifications for all 5 actions
  • Usage examples and best practices
  • Action creation guide and troubleshooting

Removed

• Deleted: auto-version-bump.yml - Functionality merged into version-bump.yml
• Deleted: gem-release.yml - Functionality merged into release.yml
• Deleted: github-release.yml - Functionality merged into release.yml
• Deleted: Deprecated wrapper scripts - build.sh, gem-publish.sh, release.sh and their .legacy versions
  • These were deprecated redirects to the new modular commands (scripts/build, scripts/release)

[0.8.1] - 2025-11-27

Added

• New Page: pages/categories.md - Browse all categories with post counts and links
  • Alphabetical category overview with badge sizing based on post count
  • Post listing under each category with descriptions and dates
  • Smooth anchor navigation between categories
• New Page: posts.html - Paginated posts index with jekyll-paginate support
  • Responsive 3-column card grid layout
  • Smart pagination with ellipsis for many pages
  • Page jump feature for quick navigation when >10 pages
• New Page: index.html - Alternative posts index with client-side pagination
  • Responsive 5-column compact card grid for high-density display
  • URL hash-based page state (#page=2) for bookmarkable pages
  • Empty state handling when no posts exist

Changed

• Enhanced: README.md - Consolidated landing page content
  • Changed layout from default to landing for proper homepage rendering
  • Updated permalink from /zer0/ to / for clean root URL
  • Added hero_image and updated preview image
  • Added “Welcome to Error-Free Jekyll Development” section with proven results metrics
  • Added “Perfect For” section highlighting target audiences
• Enhanced: pages/index.html - Improved posts archive page
  • Responsive card grid (1→2→3→4→5 columns as screen grows)
  • Client-side pagination (10 posts per page)
  • Compact card design with constrained image height
  • Category badges and post metadata display
  • Filter buttons for Categories and Tags pages
• Improved: pages/_posts/development/2025-01-22-git-workflow-best-practices.md - Front matter formatting standardization

Removed

• Deleted: index.md - Content merged into README.md to avoid duplicate landing pages

[0.8.0] - 2025-11-27

Added

• New Feature: AI Preview Image Generator (ZER0-003) - Automatic AI-powered preview image generation for Jekyll posts
  • Supports OpenAI DALL-E 3, Stability AI, and local placeholder generation
  • Configurable via _config.yml under preview_images section
  • Default retro pixel art style with 1792x1024 landscape banners
  • One-command remote installation for other Jekyll sites
• New Plugin: _plugins/preview_image_generator.rb - Jekyll integration with:
  • Liquid filters: has_preview_image, preview_image_path, preview_filename
  • Liquid tags: {% raw %}{% preview_image_status %}, {% preview_images_missing %}
  • Build hook that reports missing preview images during Jekyll build
• New Script: scripts/generate-preview-images.sh - Main CLI for image generation
  • --list-missing to find posts without preview images
  • --dry-run to preview without making changes
  • --collection to target specific collections
  • --provider to choose AI provider (openai, stability, local)
• New Script: scripts/install-preview-generator.sh - Remote installer for other repos
  • One-line installation: curl -fsSL .../install-preview-generator.sh | bash
  • Automatic configuration, VS Code tasks, and environment setup
• New Script: scripts/lib/preview_generator.py - Python alternative implementation
• New Documentation: docs/features/preview-image-generator.md - Comprehensive feature documentation
• New Rake Tasks: preview:missing, preview:generate, preview:dry_run, preview:posts, preview:docs, preview:force, preview:file
• New VS Code Tasks: Four preview image tasks for IDE integration
• New Config Section: preview_images in _config.yml with full customization options
• New Feature Entry: ZER0-003 in features/features.yml

Changed

• Updated: jekyll-theme-zer0.gemspec - Now includes _plugins/ and scripts/ directories in gem distribution
• Updated: Rakefile - Added preview image tasks and development/test task namespaces
• Updated: scripts/README.md - Documented new preview generator scripts
• Updated: .gitignore - Added .env for API key security

[0.7.2] - 2025-11-26

Fixed

• Critical: Category pages 404 error - Renamed category index files from index.md to 2000-01-01-index.md to comply with Jekyll’s _posts collection naming convention (date-prefixed filenames required)
• Category pages now correctly render at /posts/technology/, /posts/business/, /posts/development/, /posts/science/, /posts/tutorial/, /posts/world/

Added

• New sample blog posts for each category:
  • 2025-01-25-ai-tools-productivity.md (Technology)
  • 2025-01-20-startup-funding-guide.md (Business)
  • 2025-01-22-git-workflow-best-practices.md (Development)
  • 2025-01-18-quantum-computing-explained.md (Science)
  • 2025-01-23-css-grid-mastery.md (Tutorial)
  • 2025-01-21-remote-work-revolution.md (World)
• .github/prompts/commit-publish.prompt.md - Comprehensive release workflow documentation

[0.7.1] - 2025-01-30

Fixed

• Directory structure: Moved category index pages from posts/ to _posts/ directory for proper Jekyll collection handling

[0.7.0] - 2025-01-30

Added

• New Layout: category.html - Category archive pages with card grid, featured posts section, and related categories navigation
• New Layout: tag.html - Tag archive pages with breadcrumbs, tag cloud, and related tags discovery widget
• New Component: post-card.html - Reusable post card component with configurable display (badges, images, metadata, reading time)
• New Component: author-card.html - Author profile card with social links and multiple display styles (compact, full, inline)
• New Data File: authors.yml - Author profiles configuration with avatar, bio, role, and social links
• New Page: tags.md - Tags index page with tag cloud and posts grouped by tag
• New Category Pages - Six category archive pages (Development, Technology, Tutorial, World, Business, Science)
• Sample Blog Posts - Four new demo posts showcasing the blog features:
  • Docker Jekyll development guide (featured)
  • Bootstrap 5 components tutorial (featured)
  • Web accessibility guide (featured)
  • Getting started with Jekyll

Changed

• Complete Redesign: blog.html - Transformed into full-width news homepage with:
  • Dark header with category navigation
  • Hero section for breaking/featured news
  • Category quick navigation with article counts
  • Featured stories grid layout
  • Posts organized by category sections
  • Latest posts horizontal cards
  • Tags & Archives sidebar widgets
  • Newsletter signup CTA
• Enhanced: journals.html - Major improvements including:
  • Rich metadata display with author, date, reading time
  • Inlined author bio section (replaced include to fix nesting)
  • Inlined related posts section (replaced include to fix nesting)
  • Card-based post navigation (previous/next)
  • Giscus comment integration support
• Updated: _data/navigation/posts.yml - Reorganized categories with Bootstrap icons and proper hierarchy
• Refactored: sidebar-folders.html - Simplified structure with icon support
• Refactored: branding.html - Fixed URL references, added comprehensive documentation
• Refactored: js-cdn.html - Cleaned up, removed redundant Popper.js (included in Bootstrap bundle)

Fixed

• Critical: Liquid “Nesting too deep” error - Resolved recursive include issues by inlining card content in layouts
• Post filtering - Added where_exp filters to exclude index pages from post listings
• Script loading performance - Added defer attribute to non-critical scripts in head.html
• Reading time calculation - Changed from calculated to front matter estimated_reading_time to avoid recursion

[0.6.0] - 2025-11-22

Added

• Implement PostHog analytics and cookie consent
• Add code copy functionality and enhance documentation structure
• Revise copilot instructions and add comprehensive Jekyll include development guidelines
• Implement automatic theme version display with comprehensive system information
• Add automatic theme version display and system information integration
• Enhance Copilot instructions with comprehensive guidelines
• Enhance CI/CD testing framework with comprehensive documentation and automated workflows

Changed

• Ignore .frontmatter directory
• Update VS Code settings
• Documentation: Update README with new features and architecture
• Documentation: Add documentation architecture guidelines
• Refactor: Clean up redundancies in includes.instructions.md
• Update version control instructions and add feature documentation

Other

• Revert “Merge pull request #10 from bamr87/copilot/plan-mdx-file-handling”
• Add Mermaid documentation and test suite, enhance site structure
• Merge pull request #9 from bamr87/copilot/setup-copilot-instructions
• Merge branch ‘main’ into copilot/setup-copilot-instructions
• Merge pull request #10 from bamr87/copilot/plan-mdx-file-handling
• Address code review feedback and add summary documentation
• Improve MDX processing and add comprehensive tests
• Add MDX and Tailwind CSS support to zer0-mistakes theme
• Initial plan
• Initial plan

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

• Comprehensive documentation organization system in /docs/ directory
• Standardized templates for feature documentation, release notes, and change tracking
• Organized directory structure for releases, features, systems, and configuration documentation

Changed

• Migrated scattered documentation files to organized structure
• Improved documentation discoverability and maintenance

0.5.0 - 2025-10-25

Added

• 📊 Comprehensive Sitemap Integration: Unified layout combining collections, statistics, and navigation
  • Real-time site statistics dashboard with 6 key performance indicators
  • Interactive search and filtering across all content types
  • Collections overview with detailed analysis and recent item previews
  • Advanced content discovery tools with visual organization
  • Mobile-optimized responsive design with touch-friendly interface
  • Dark mode support with theme-aware styling
• 🔧 Enhanced User Experience Components: Modern interface with professional design
  • Bootstrap 5-based responsive layout with hover animations
  • WCAG 2.1 AA compliant accessibility features
  • Performance-optimized loading with lazy content rendering
  • Comprehensive documentation and implementation guides

Changed

• 🏗️ Navigation System: Consolidated duplicate sitemap entries into unified comprehensive view
• 🎨 Visual Design: Updated to modern card-based layout with smooth transitions
• 📱 Mobile Experience: Enhanced mobile responsiveness and touch interactions

Fixed

• 🐛 Dark Mode Compatibility: Resolved background color issues in dark theme
• 🔧 Collection Filtering: Fixed functionality for dynamic content filtering
• 🔗 Link Navigation: Corrected internal link behavior and navigation flow

Technical Details

• Files Added: _layouts/sitemap-collection.html, enhanced navigation data files
• Files Modified: Main navigation configuration, sitemap pages
• Performance: Optimized DOM manipulation and content rendering
• Accessibility: Full screen reader support and keyboard navigation

Full Documentation: v0.5.0 Release Summary

0.4.0 - 2025-10-10

Added

• 📊 Comprehensive Site Statistics Dashboard: Complete analytics system for content insights
  • Dynamic statistics generation from site content using Ruby script
  • Real-time analytics showing content pieces, categories, tags, and word counts
  • Interactive Bootstrap 5-based dashboard with responsive design
  • Modular component architecture with 6 specialized statistics components
  • Intelligent activity level calculations based on actual data distribution
  • Professional tag cloud visualization with dynamic sizing
  • Mobile-optimized layout with smooth animations and transitions
• 🔧 Advanced Data Processing Engine: Automated content analysis and metric generation
  • Ruby-based statistics generator script analyzing posts, pages, and collections
  • YAML data file generation with comprehensive site metrics
  • Smart categorization and tagging analysis with usage frequency tracking
  • Monthly content distribution analysis and trend identification
• 🎨 Enhanced User Experience Components: Professional dashboard interface
  • Bootstrap 5-first design approach with minimal custom CSS
  • Card-based layout for metric organization and visual hierarchy
  • Interactive tooltips and progress indicators for enhanced usability
  • Print-friendly styling and accessibility compliance (ARIA support)
  • Smooth scroll navigation and fade-in animations for modern UX

Changed

• 📈 Activity Level Intelligence: Dynamic threshold calculation replacing static values
  • Categories: High activity (≥70% of max), Medium (≥40% of max), Low (remainder)
  • Tags: Frequently used (≥60% of max), Moderately used (≥20% of max), Occasionally used (remainder)
  • Real-time adaptation to content distribution patterns
• 🏗️ Template Architecture: Modular include system for maintainable code
  • Separated concerns across 6 specialized components
  • Clean Liquid template syntax with proper error handling
  • Optimized data processing without complex sorting operations

Fixed

• 🐛 Data Display Issues: Resolved template rendering and data access problems
  • Fixed Liquid template syntax errors causing empty displays
  • Corrected data structure references across all components
  • Eliminated type conversion errors in sorting operations
  • Proper handling of nested array data structures

Full Documentation: v0.4.0 Release Summary

0.3.0 - 2025-01-27

Added

• 🎨 Mermaid Diagram Integration v2.0: Comprehensive diagramming system
  • Complete diagram support: flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, git graphs, journey diagrams, and mindmaps
  • GitHub Pages compatibility with both local development and deployment
  • Conditional loading for performance optimization
  • Responsive design with automatic scaling across devices
  • Dark mode support with forest theme optimization
• 📚 Comprehensive Documentation: Complete user and developer guides
  • Step-by-step user guide with live examples
  • Developer-focused integration tutorial
  • Live test suite with validation examples
  • Comprehensive troubleshooting guide
• 🧪 Automated Testing Framework: Complete validation system
  • 16 automated tests covering all aspects
  • Multiple test modes: quick, local, Docker, headless
  • Cross-browser compatibility testing
  • Performance validation and benchmarking

Changed

• 📁 File Organization: 53% reduction from 15 to 7 Mermaid-related files
• 🏗️ Architecture: Modular include system with clear responsibilities
• 📖 Documentation: Consolidated and improved documentation structure

Fixed

• 🔧 Configuration: Enhanced Jekyll and GitHub Pages compatibility
• ⚡ Performance: Optimized loading and rendering speed
• 🎯 Usability: Improved setup process and error handling

Full Documentation: v0.3.0 Release Notes

0.2.1 - 2025-09-30

Added

• Enhanced markdown linting configuration
• Improved Jekyll template support for link checking
• Better configuration for markdown validation

Changed

• Updated markdown-link-check configuration with Jekyll-specific patterns
• Relaxed line length requirements in markdownlint configuration
• Added support for more HTML elements in markdown

Fixed

• Improved markdown validation for Jekyll projects
• Better handling of Liquid templates in link validation

0.2.0 - 2025-09-01

Changed

• Version bump to 0.2.0 with improvements

0.1.9 - 2025-01-27

Added

• 🐳 Docker-First Development Evolution: Complete transformation to containerized development
  • AI-powered init_setup.sh with intelligent environment detection and auto-healing
  • Cross-platform Docker Compose configuration with Apple Silicon optimization
  • Self-healing _config_dev.yml generation for Docker compatibility
  • Enhanced install.sh with Docker-first optimization functions
  • Comprehensive Docker troubleshooting and platform detection
• 🧠 AI-Powered Self-Healing Configuration: Intelligent automation and error recovery
  • Auto-detection and resolution of Jekyll theme dependency issues
  • Intelligent platform-specific optimizations (Intel/Apple Silicon)
  • Automatic generation of Docker-compatible development configurations
  • Smart error recovery with detailed logging and guidance
• 🚀 Enhanced Installation System: Robust, error-tolerant setup process
  • optimize_development_config() function for Docker-friendly configs
  • fix_content_issues() function to resolve Jekyll include problems
  • Comprehensive error handling with actionable troubleshooting steps
  • AI-generated documentation and setup instructions

Changed

• 🔧 Installation Philosophy: Shifted from traditional Ruby/Jekyll setup to Docker-first approach
  • Disabled local theme dependencies to avoid gemspec issues
  • Optimized for containerized development environments
  • Enhanced cross-platform compatibility and consistency

Fixed

• 🐛 Theme Dependency Issues: Resolved Jekyll theme not found errors
  • Commented out problematic Jekyll includes in README.md
  • Disabled remote_theme in development configuration
  • Added essential Jekyll plugins for Docker compatibility
• 🍎 Apple Silicon Compatibility: Fixed Docker platform issues
  • Added platform: linux/amd64 for Apple Silicon compatibility
  • Automatic platform detection and optimization
  • Cross-architecture Docker image support

0.1.8 - 2025-01-03

Added

• Comprehensive Gem Automation System: Unified automation ecosystem
  • Zero-click releases with multi-environment testing
  • Production-ready CI/CD pipeline with GitHub Actions integration
  • Semantic versioning, building, testing, and publishing automation
  • Complete documentation consolidation following IT-Journey principles
• Remote Installation Support: Direct installation from GitHub
• Azure Static Web Apps Integration: Automatic workflow creation for Azure deployment
• Build Directory Structure: Added build/ directory for logs and temporary files
• Enhanced Error Handling: Comprehensive error handling with colored output
• Cleanup Functions: Automatic cleanup of temporary files after remote installation

Changed

• Feature Documentation Restructure: Consolidated redundant automation feature entries
• Simplified Installation Process: Updated to use single install command
• Azure-Ready Configuration: Pre-configured directory structure for Azure Static Web Apps
• Enhanced Documentation: Updated with Azure deployment instructions
• Improved Help System: Added remote installation examples

Removed

• Redundant Documentation: Eliminated duplicate automation documentation files

Fixed

• Installation Script Compatibility: Made compatible with both local and remote execution
• Directory Structure: Optimized for Azure Static Web Apps deployment
• Markdown Lint Issues: Fixed all markdown formatting violations

0.1.7 - 2024-12-01

Added

• Bootstrap Jekyll theme for headless GitHub Pages CMS
• Basic theme structure with layouts, includes, and assets
• Jekyll compatibility with GitHub Pages
• Scripts for version management, build, and test automation
• GitHub Actions workflows for CI/CD
• Makefile for simplified command access

Changed

• Initial theme implementation and project structure

---

Documentation

For detailed documentation on features, systems, and configuration:

• Documentation Center - Complete documentation overview
• Release Documentation - Historical release information
• Feature Documentation - Detailed feature guides
• System Documentation - Core systems and automation
• Configuration Guides - Setup and configuration

Links