Changelog

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

[2.5.0] - 2025-01-27

Added

Quest Network Validation & Fixes (Phase 6)

Complete quest network validation and frontmatter standardization across all 147 quests.

• scripts/fix-quest-frontmatter.py - New automated frontmatter fixer script
  • Removes placeholder dependencies (unlocks_quests, prerequisites)
  • Adds missing required fields (difficulty, estimated_time, quest_type)
  • Normalizes quest_type and difficulty values to valid options
  • Dry-run mode for safe previewing
  • Fixed 284 issues across 90 files
• pages/_quests/lvl_0110/README.md - New level README (Advanced Quests I)
• pages/_quests/lvl_0111/README.md - New level README (Advanced Quests II)
• pages/_quests/lvl_1000/README.md - New level README (Expert Quests I)
• pages/_quests/lvl_1001/README.md - New level README (Expert Quests II)
• pages/_quests/docs/ - New documentation directory for phase plans

Documentation

• pages/_quests/PHASE6_PLAN.md - Detailed Phase 6 execution plan with 5-week timeline
• pages/_quests/docs/PHASE1-5_COMPLETE.md - Archived phase completion summary
• pages/_quests/docs/VALIDATION_FIXES_SUMMARY.md - Archived validation fixes summary

Changed

Quest Frontmatter Standardization (~120 files)

• Removed all placeholder unlocks_quests and prerequisites references
• Added missing difficulty fields with contextually appropriate values
• Added missing estimated_time fields
• Normalized quest_type values to valid options (main_quest, side_quest, epic_quest, bonus_quest, reference)
• Normalized difficulty values to valid options (🟢 Easy, 🟡 Medium, 🔴 Hard, ⚔️ Epic)
• Fixed duplicate frontmatter keys in sec-edgar.md
• Cleared broken inter-quest dependencies (314 → 0 broken deps)

Validation System

• scripts/validate-quest-network.py - Updated to exclude /docs/ directory from scanning
• pages/_quests/QUEST_BUILD_PLAN.md - Updated with Phase 6 status, quest counts, and version 2.0.0

Fixed

• 318 validation errors → 0 errors - Complete quest network integrity
• Removed 314 broken dependency references
• Fixed invalid quest_type values (guide → reference, etc.)
• Fixed invalid difficulty values (intermediate → 🟡 Medium, etc.)
• Fixed sec-edgar.md missing title and duplicate description fields

Validation Results

• Total Quests: 147
• Complete Quests: 29
• Broken Dependencies: 0
• Errors: 0
• Warnings: 444 (non-blocking orphan quests - expected during development)

[2.4.1] - 2025-12-28

Added

• _data/navigation/quests.yml - New navigation file for quest collection with all levels (0000-0101)
• _data/navigation/notebooks.yml - New navigation file for notes/cheatsheets collection

Changed

Navigation System Alignment

• _data/navigation/main.yml - Fixed broken /zer0/ link, reorganized sections (Quick-Start, Journey, Library, Notebook, About)
• _data/navigation/about.yml - Removed non-existent pages (/about/approach, /about/license, /about/terms)
• _data/navigation/docs.yml - Complete rewrite to match actual _docs collection content
• _data/navigation/hobbies.yml - Simplified to existing /hobbies/ page only
• _data/navigation/home.yml - Fixed broken /roadmap/ reference, added Journey section
• _data/navigation/posts.yml - Removed broken entries, added Business category
• _data/navigation/quickstart.yml - Removed non-existent platform-specific pages

Sidebar Configuration

• _config.yml - Updated sidebar nav settings: _quests collection uses quests nav, _notes uses notebooks, added _notebooks collection scope
• pages/_about/settings/_config.yml - Synced with main config changes

Documentation

• _data/README.md - Added comprehensive navigation files table and sidebar modes documentation

[2.4.0] - 2025-12-20

Added

SEO & Content Automation Scripts (Ruby)

Three new Ruby automation scripts for Docker/Jekyll environment:

• scripts/frontmatter-validator.rb - Comprehensive frontmatter validation
  • Multi-type validation (posts, quests, docs, notes)
  • SEO scoring system (0-100 points)
  • JSON report export
  • CLI options for filtering and verbose output
  • Validates 343 files with 91.5% validity rate
• scripts/ctr-report-generator.rb - SEO/CTR report generation
  • Baseline metrics from Google Search Console
  • Weekly review template generation
  • Opportunities analysis for improvement
  • CSV parsing and JSON export
• scripts/content-freshness-check.rb - Content age tracking
  • Freshness categories (fresh/aging/stale/critical/unknown)
  • Content health scoring (56.2% current health)
  • Priority-ranked action items
  • Markdown and JSON report exports
  • Content-type specific thresholds

SEO Data & Reports

• TODO/seo/data/frontmatter-report.json - Full validation report (343 files)
• TODO/seo/data/seo-metrics.json - SEO baseline metrics
• TODO/seo/data/freshness-report.json - Content freshness data
• TODO/seo/reports/weekly-review-2025-12-20.md - Weekly review template
• TODO/seo/reports/content-freshness-2025-12-20.md - Freshness report

Changed

• TODO Status Dashboard: Updated TODO/STATUS.md with Automation category at 100% completion
• TODO README: Updated TODO/README.md with completed automation scripts and usage examples
• Scripts README: Added comprehensive SEO Automation section with usage examples

Documentation

• Updated scripts/README.md with SEO & Content Automation section
• Added usage examples for all three Ruby scripts
• Documented SEO scoring methodology and freshness thresholds

[2.3.0] - 2025-12-20

Added

Comprehensive SEO Optimization Project (4 Phases)

• Phase 1 - Quick Wins: Optimized 6 high-impression pages with proper titles, meta descriptions, and canonical URLs
• Phase 2 - Systematic Quest SEO: Updated 88 quest files with proper SEO frontmatter
  • Added descriptive titles with primary keywords (e.g., “Docker Containerization Mastery” vs “Docker Quest”)
  • Added unique meta descriptions (150-160 chars) explaining learning outcomes
  • Added structured tags and keywords for discoverability
  • Fixed placeholder values like [Descriptive Subtitle], [main-tech], [skill-category]
• Phase 3 - High-Demand Content: Created 3 new SEO-optimized articles targeting search gaps
  • pages/_docs/terminal/terminal-shortcuts-cheat-sheet.md - Comprehensive terminal shortcuts reference
  • pages/_posts/devops/2025-12-20-docker-beginners-tutorial.md - Docker beginner tutorial
  • pages/_posts/tools & environment/2025-12-20-essential-vscode-extensions-developers.md - VS Code extensions guide
• Phase 4 - Monitoring Infrastructure: Set up tracking systems for ongoing SEO health
  • TODO/seo/MONITORING_DASHBOARD.md - Weekly tracking templates, GSC checklists, A/B testing log
  • scripts/seo-tracker.py - Python CLI for baseline reports, weekly templates, opportunity analysis
  • TODO/seo/TRACKING.md - Performance metrics and baseline data

TODO System Reorganization

• Created TODO/STATUS.md - Central dashboard for all project work
• Created TODO/seo/ - Dedicated SEO project directory with structured files
• Created TODO/templates/ - Reusable templates for different task types
• Created TODO/ARCHIVE/ - Storage for completed project documentation
• Created .github/instructions/todo.instructions.md - AI agent guidelines for TODO management

Changed

• Roadmap Update: Refreshed roadmap.md with current priorities and timeline
• Quest Frontmatter Standardization: All 88 quest files now follow consistent SEO-optimized format

Removed

• Deleted obsolete TODO files: TODO/SEO_OPTIMIZATION_PLAN.md, TODO/QUICK_ACTIONS.md, TODO/TRACKING_TEMPLATE.md

[2.2.0] - 2025-11-29

Added

• PRD Machine Docker Integration: Added prd-machine service to docker-compose.yml for containerized PRD generation
• New Quest: 2025-11-29-prd-codex-mastering-product-reality-distillation.md - Level 0011 educational quest teaching Product Requirements Documents and PRD Machine usage with fantasy RPG theme
• PRD Machine CLI: Python-based tool (scripts/prd-machine/prd-machine.py) with three commands:
  • sync - Generate/update PRD.md from repository signals
  • status - Check PRD health and freshness
  • conflicts - Detect and display PRD conflicts

Changed

• PRD Content Refactor: Regenerated PRD.md to document the IT-Journey platform instead of self-referential PRD Machine documentation
• PRD Section Generators: Updated all section generators in prd-machine.py to output IT-Journey focused content (WHY, MVPs, Key Signals, etc.)

Documentation

• Updated pages/_quests/README.md with new PRD Codex quest entry
• PRD Machine README at scripts/prd-machine/README.md provides complete usage guide

  Changed

Content Organization Improvements (2025-12-17)

• Consolidated Blog Post Index: Replaced multiple duplicate post index files with a unified pages/posts.md
  • Removed redundant files: pages/_posts/2000-01-01-index.md, pages/_posts/README.md
  • Removed duplicate home section files: pages/_posts/home/2025-11-16-blog-posts-it-journey.md, pages/_posts/home/2025-11-16-posts.md
  • Created new unified post index at pages/posts.md with improved table-based category overview
  • Enhanced structure with better organization and visual layout
  • Updated frontmatter with current timestamp and version 2.0.0

Fixed

Link Health Improvements (2025-12-11)

• Removed Broken Internal References:
  • Removed /zer0/ bookmark from pages/home.md (404 error)
  • Updated quest example in stating-the-stats.md from /blog/ to /posts/
• Enhanced Link Checker Configuration:
  • Excluded _site/preview/ directory to eliminate ~15,000 false positives
  • Excluded work/ directory from link checking
  • Added exclusion patterns for rate-limited URLs (GitHub blob URLs, Reddit share buttons)
  • Reduced total link checks from 152K to 78K (48% reduction in noise)
  • Reduced broken link reports from 19,877 to 10,680 (46% reduction)
  • Reduced unique broken URLs from 2,173 to 1,696 (22% reduction)
• Added Comprehensive Link Analysis Documentation:
  • link-check-results/ANALYSIS_SUMMARY.md - Statistical analysis of link health
  • link-check-results/FIXES_APPLIED.md - Detailed documentation of fixes and remaining issues
  • link-check-results/detailed_analysis.md - Automated link failure analysis
  • link-check-results/ai_analysis.md - AI-powered link health insights

Added

AI-Generated Quest Preview Images (2025-12-01)

• 107 New Preview Images: AI-generated preview images for all quest levels using DALL-E 3
  • Level 0000-1111 README banners with consistent retro pixel art style
  • Individual quest preview images for 100+ quests
  • Images stored in assets/images/previews/

Enhanced Preview Generator Script

• New Feature: Batch Processing - Process multiple files with --batch N flag
• New Feature: Rate Limiting - Token bucket rate limiter for API calls (5 req/min default)
• New Feature: Logging Support - File logging with --log-file flag
• New Feature: Interrupt Handling - Graceful shutdown on Ctrl+C with progress preservation
• New Feature: Progress Tracking - Real-time progress bar and ETA during batch generation
• New Feature: Retry Logic - Automatic retries with exponential backoff for API failures

Fixed

• Jekyll Build Error: Added work/ directory to Jekyll exclude list to prevent symlink errors from local Python virtual environments

Quest Collection Layout System

• New Layout: quest-collection.html - Dynamic layout for displaying quests grouped by binary level tiers (Apprentice, Adventurer, Warrior, Master)
• New Include: quest-card.html - Reusable quest card component with data attributes for filtering
• New Include: quest-filters.html - Interactive filtering UI with JavaScript for quest type, difficulty, level, technology, and search
• New Include: quest-stats.html - Statistics display component showing quest counts by type and difficulty
• New Include: quest_card.html - Alternative quest card with BEM-style CSS classes
• New Include: quest_grid.html - Grid layout component for quest collections
• New Include: quest_stats.html - Alternative statistics component with time estimation

New Quest

• Side Quest: jekyll-quest-tracking.md (Level 0101, 🔴 Hard, 4-6 hours)
  • Master Jekyll’s collection system by building a quest tracking interface
  • Covers: Liquid templating, JavaScript filtering, Python automation
  • Includes 5 chapters and 4 mastery challenges
  • Complete with Mermaid diagrams for quest network and implementation flow

Automation Scripts

• New Script: update_level_readmes.py - Python script to ensure consistent frontmatter across level README files
  • Adds missing layout: quest-collection, level, and categories fields
  • Uses regex to detect 4-digit binary level directories

Changed

• Quest Index: Updated pages/_quests/README.md to use quest-collection layout
• Level READMEs: All level README files (0000-1111) updated with consistent frontmatter:
  • Added layout: quest-collection for dynamic quest display
  • Added level field matching directory name
  • Added categories: quests for proper collection filtering
• Level 0101 README: Added new Jekyll Quest Tracking side quest entry with updated Mermaid diagram

Fixed

• Integer/String Sorting: Quest filters now handle mixed Integer/String level values by coercing to strings before sorting

[Previous Unreleased]

Added

Phase 5: Master Tier Quest Generation (Levels 1100-1111)

• 32 New Quests: Complete Master Tier quest generation across 4 levels
  • Level 1100 - Data Engineering (5 new quests):
    • apache-spark.md - Big Data Processing with Spark
    • data-quality.md - Data Quality & Validation
    • data-warehousing.md - Data Warehouse Design
    • etl-pipeline-design.md - ETL Pipeline Architecture
    • stream-processing.md - Real-time Data Streams
  • Level 1101 - Machine Learning & AI (8 new quests):
    • ai-ethics.md - Responsible AI Development
    • computer-vision.md - Image & Video Analysis
    • deep-learning-frameworks.md - TensorFlow & PyTorch
    • ml-fundamentals.md - Machine Learning Basics
    • mlops.md - ML Operations & Deployment
    • natural-language-processing.md - NLP Fundamentals
    • neural-networks.md - Deep Learning Architecture
    • python-data-science.md - Python for Data Science
  • Level 1110 - Architecture & Design (7 new quests):
    • api-gateway-patterns.md - API Gateway Design
    • design-patterns.md - Software Design Patterns
    • domain-driven-design.md - DDD Principles
    • event-driven-design.md - Event-Driven Architecture
    • microservices-architecture.md - Microservices Design
    • scaling-strategies.md - Horizontal & Vertical Scaling
    • system-design-interviews.md - System Design Practice
  • Level 1111 - Leadership & Innovation (8 new quests):
    • architecture-reviews.md - Technical Review Process
    • building-technical-communities.md - Community Building
    • career-advancement.md - IT Career Growth
    • innovation-rnd.md - R&D Leadership
    • mentorship-programs.md - Mentoring Skills
    • open-source-contribution.md - OSS Contribution
    • tech-speaking-writing.md - Technical Communication
    • technical-leadership.md - Tech Lead Skills

Quest Validation Improvements

• Quest Template Update: Added fmContentType: quest field to .frontmatter/templates/quests.md
• Validation Rules Documentation: Added comprehensive validation rules section to .github/instructions/quest.instructions.md including:
  • Required frontmatter fields table
  • Enhanced fields table
  • Content structure validation requirements
  • Difficulty level guidelines
  • Binary level system reference
  • Validation commands and score thresholds
  • Common issues and fixes guide

Fixed

• fmContentType Field: Added missing fmContentType: quest to 35 quest files:
  • All 32 new quests in levels 1100-1111
  • 3 existing quests: edgar.md, sec-edgar.md, the-temple-of-templates.md
• Jekyll Build Error: Fixed invalid preview field in 2 blog posts:
  • 2025-06-29-planting-seeds-software-evolution.md - Changed text to image path
  • 2025-07-09-fixing-github-actions-bash-compatibility-ai-evolution-engine.md - Changed text to image path

Changed

• Quest README: Updated pages/_quests/README.md:
  • Removed “Coming Soon” labels from levels 1101 and 1111
  • Added links to all new quests in levels 1100-1111
  • Updated quest counts and completion status

Quest System Status Update

• Total Quests: 162 quests (130 previous + 32 new)
• Levels Complete: 16 of 16 levels (100%) ✅
• Phases Complete: 5 of 6 phases (83%)
  • Phase 5: Master Tier ✅ (NEW)

Added

Phase 4: Expert Tier Quest Generation (Phases 1-4 Complete)

• 72 New Placeholder Quests: Complete quest generation across 4 phases
  • Phase 2 - Apprentice Tier (Levels 0000-0011): 17 quests
    • Level 0000: terminal-fundamentals.md, git-basics.md, markdown-mastery.md
    • Level 0001: github-pages-basics.md, jekyll-fundamentals.md, liquid-templating.md, yaml-configuration.md, git-workflow-mastery.md
    • Level 0010: advanced-markdown.md, css-styling-basics.md, javascript-fundamentals.md, bootstrap-framework.md
    • Level 0011: advanced-git-workflows.md, jekyll-plugins.md, seo-optimization.md, analytics-integration.md, custom-domains.md
  • Phase 3 - Journeyman Tier (Levels 0100-0111): 36 quests
    • Level 0100: container-fundamentals.md, docker-compose-orchestration.md
    • Level 0101: 8 CI/CD quests (cicd-fundamentals.md, github-actions-basics.md, testing-integration.md, etc.)
    • Level 0110 (NEW): 8 database quests (database-fundamentals.md, sql-mastery.md, data-modeling.md, etc.)
    • Level 0111 (NEW): 7 API quests (api-fundamentals.md, rest-principles.md, api-authentication.md, etc.)
  • Phase 4 - Expert Tier (Levels 1000-1011): 19 quests
    • Level 1000 (NEW): 6 cloud quests (cloud-computing-fundamentals.md, aws-essentials.md, infrastructure-as-code.md)
    • Level 1001 (NEW): 4 Kubernetes quests (kubernetes-fundamentals.md, k8s-pods-workloads.md, k8s-services-networking.md, k8s-config-secrets.md)
    • Level 1010: 5 monitoring quests (monitoring-fundamentals.md, prometheus-grafana.md, elk-stack.md, distributed-tracing.md, alerting-systems.md)
    • Level 1011: 5 security quests (security-fundamentals.md, threat-modeling.md, secure-coding.md, penetration-testing.md, compliance-standards.md)

Quest Infrastructure & Automation

• Quest Generation Script: scripts/generate-placeholder-quest.sh - Automated quest file generation from templates
• Quest Validator: scripts/validate-quest-network.py - Python-based frontmatter and network validation
• Quest Tools Wrapper: scripts/quest-tools.sh - Docker wrapper for validation tools
• Quest Templates: pages/_quests/templates/ directory with main-quest-template.md and level-readme-template.md
• Docker Validation Environment: Multi-service setup in docker-compose.yml with quest-validator and quest-network-validator services
• Python Dependencies: scripts/requirements.txt for PyYAML and validation tools

Quest Documentation

• QUEST_BUILD_PLAN.md: 14-week roadmap for complete quest system (6 phases, 97 quests)
• PHASE1_COMPLETE.md: Infrastructure phase documentation
• PHASE2_COMPLETE.md: Apprentice Tier (17 quests) completion summary
• PHASE3_COMPLETE.md: Journeyman Tier (36 quests) completion summary
• PHASE4_COMPLETE.md: Expert Tier (19 quests) completion summary with technical coverage breakdown
• VALIDATION_FIXES_SUMMARY.md: Documentation of 44 frontmatter validation fixes across 58 original quests

Other Additions

• Preview images for various quests in assets/images/previews/
• README.md files: Added README.md to all level directories (0000, 0001, 0010, 0011, 0100, 0101, 1010, 1011, 1100, 1110)
• inventory/README.md: New directory for learner progress tracking (future feature)
• tools/README.md: Collection documentation for cross-level tool quests
• Directory Structure section: Added comprehensive structure documentation to main quests README.md
• Binary Level System table: Complete 16-level table (0000-1111) with status indicators and reserved levels

Changed

Quest Frontmatter Standardization

• 44 Frontmatter Validation Fixes: Systematic fixes across 58 original quest files
  • Added missing level field to all quests following binary format (0000-1111)
  • Added missing quest_type field (main_quest, side_quest, bonus_quest, epic_quest, reference)
  • Added missing difficulty field (🟢 Easy, 🟡 Medium, 🔴 Hard, ⚔️ Epic, 📚 Reference)
  • Added missing estimated_time field with proper format
  • Standardized permalink field structure
  • Added missing title and description fields
  • Fixed invalid difficulty values and quest types
  • Fixed invalid level formats to 4-digit binary

Docker Infrastructure Updates

• Dockerfile: Added Python 3.11 venv setup at /opt/venv for quest validation
• docker-compose.yml: Added multi-service validation environment
  • quest-validator service for individual quest validation
  • quest-network-validator service for network-wide validation
  • Shared volume mounts for scripts and quest directories

Quest System Status

• Total Quests: 130 quests (58 original + 72 generated)
• Levels Complete: 12 of 16 levels (75%)
  • Original levels: 0000, 0001, 0010, 0011, 0100, 0101, 1100, 1110
  • New levels: 0110, 0111, 1000, 1001, 1010, 1011
• Phases Complete: 4 of 6 phases (67%)
  • Phase 1: Infrastructure ✅
  • Phase 2: Apprentice Tier ✅
  • Phase 3: Journeyman Tier ✅
  • Phase 4: Expert Tier ✅
  • Phase 5: Master Tier (pending)
  • Phase 6: Polish & Integration (pending)

Major Quest Reorganization

• init_world/ → 0000/ (Foundation & Init World)
• lvl_000/ → 0000/ (merged with init_world content)
• lvl_001/ → 0001/ (Journeyman Challenges)
• lvl_0010/ → 0010/ (Terminal Enhancement)
• frontend/ → 0100/ (Frontend & Docker)
• Tool quests → tools/ directory
• Quest examples → codex/ directory
• File Naming: Removed date prefixes from all quest files (e.g., 2024-05-28-bash-run.md → bash-run.md)
• Code Files: Moved script/code examples from level root directories to subdirectories (scripts/, examples/)
• Updated paths: All internal quest links updated to new binary-coded paths in README.md and home.md
• Updated scripts/lib/preview_generator.py for enhanced preview generation
• Updated test/quest-validator/requirements.txt for validator dependencies

Removed

• Legacy directory structure (init_world/, lvl_000/, lvl_001/, lvl_0010/, frontend/, examples/)
• Date prefixes from 75+ quest files
• Duplicate 0000/tools/ directory (consolidated to root tools/)

Migration Notes

• Quest permalinks may have changed - update any external references
• Binary level directories (0000-1110) replace legacy naming convention
• Code examples now live in subdirectories within level folders

2.1.0 - 2025-11-26

Added

• New Quest: 2025-11-26-prompt-crystal-mastery-vscode-copilot-quest.md - Comprehensive VS Code Copilot prompt engineering quest with RCTF patterns, few-shot prompting, and reusable template creation
• New Post: 2025-11-26-mastering-prompt-engineering-vscode-copilot.md - Tutorial companion to the prompt engineering quest
• New Prompt Template: commit-publish.prompt.md - Complete release pipeline workflow for semantic versioning and publishing
• Enhanced Prompt: draft-article.prompt.md v2.0.0 - Major upgrade with RCTF pattern, Kaizen-driven structure, intake checklists, and quality gates
• CRUSH Workflow System: Added .crush/workflows/CRUSH_WORKFLOW_SYSTEM_SUMMARY.md documentation

Changed

• Documentation Reorganization: Moved summary files from repository root to organized /docs/ subdirectories:
  • ABOUT_REORGANIZATION_SUMMARY.md → docs/architecture/
  • QUEST_TEMPLATE_ENHANCEMENT_SUMMARY.md → docs/standards/
  • DEPENDENCY_UPDATE_SUMMARY.md → docs/workflows/
  • LINK_CONSOLIDATION_SUMMARY.md → docs/workflows/
• Updated docs/README.md with links to newly organized documentation (v1.1.0)
• Updated .gitignore to exclude log files from root directory and logs/*.log

Removed

• Cleaned up repository root:
  • Removed .seed.md (seed content moved to proper locations)
  • Removed .github/workflows/blank.yml (unused workflow)
  • Removed prompts/seed.prompt.yml and prompts/seed_prompt.md (consolidated)
  • Removed test-mermaid.html (moved to test/ directory)
  • Removed various log files (add-date-prefixes.log, post-organization.log)

Fixed

• Improved .gitignore patterns to prevent log file accumulation in repository

2.0.0 - 2025-11-16

Changed

• BREAKING: Weekly Post Organization workflow now creates pull requests instead of directly committing to main branch
  • This change requires manual review and approval of automated post organization changes
  • PRs are automatically labeled and assigned for review
  • Provides safety and traceability for all automated content changes

Migration Notes

• Existing workflow behavior: Posts were automatically organized and committed to main
• New workflow behavior: Posts are organized and a PR is created for review
• Action required: Review and merge PRs created by the workflow
• No script changes required: organize-posts.py and organize-posts.sh work as-is

Technical Details

• Workflow: .github/workflows/organize-posts-weekly.yml
• Implementation: Uses standard GitHub Actions (git commands + GitHub CLI)
• Branch pattern: automated/organize-posts-{run_id}
• PR configuration:
  • Title: 🤖 Weekly Post Organization - {run_id}
  • Labels: automated, content-organization, posts
  • Assignee: bamr87
  • Includes: Workflow link, change summary, next steps

Documentation

• Consolidated workflow documentation in docs/workflows/ORGANIZE_POSTS_WORKFLOW.md
• Includes: Process flow, implementation details, testing guide, troubleshooting
• Removed temporary documentation files from repository root

1.0.0 - 2025-11-16

Initial Release

• Weekly Post Organization workflow with direct commit to main branch
• Automated organization of posts by section using frontmatter metadata
• Automated archiving of posts older than configurable threshold
• Scheduled execution every Sunday at 2 AM UTC
• Manual trigger with dry-run option

Changelog Maintenance

This changelog is manually maintained. When making changes:

1. Add new entries under [Unreleased] section
2. Use categories: Added, Changed, Deprecated, Removed, Fixed, Security
3. Include migration notes for breaking changes
4. Link to relevant documentation
5. Move [Unreleased] items to a new version section when releasing

Version Numbering

• Major version (X.0.0): Breaking changes that require user action
• Minor version (0.X.0): New features, non-breaking changes
• Patch version (0.0.X): Bug fixes, documentation updates

Theme Fixes (2025-12-12)

Fixed - Theme Social Button URLs

• Pull Request: zer0-mistakes#15
• Branch: fix/social-button-urls
• Commit: 866e26b

Changes

• Fixed social sharing buttons to use production URLs instead of localhost
• Updated _includes/content/intro.html: Reddit, LinkedIn, Twitter, copy link buttons
• Updated _layouts/notebook.html: Twitter, LinkedIn, email share buttons
• Replaced https://it-journey.dev/CHANGELOG/ with https://it-journey.dev/CHANGELOG/

Impact

• Resolves 353 unique broken URLs (20.8% of all broken link types)
• Eliminates false positives in link health checks
• Social buttons now work correctly in all environments
• Expected 46% reduction in unique broken URL types after theme merge

Documentation

• Created link-check-results/THEME_FIXES.md with comprehensive details
• Technical implementation notes and testing procedures included
• Deployment process and expected improvements documented