bilingual-jekyll-resume-theme 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8fb9be1096f1c150e9d04dade9091453ad65aee770b47550fa2fd234e4f4960
-  data.tar.gz: 3e2b21e42d72f16e81d6a066a24834f031acf548a0b96edd744131d255a2abcb
+  metadata.gz: b8eb8d16040a681b4a06c1d6eba60b957aee132434d038ce56b53415e74774f9
+  data.tar.gz: e7cb05ea3e65d241cab36fb5734062a13af1931e8cabe736ee749a108bf8655b
 SHA512:
-  metadata.gz: 57375b0522accc404a40ca9082d836b4accb27c73b36890a97cbb9e4c5647da2e7d55942da194adc3bb35be30f77443148d34944ea9dbbe3e455402e6f21a595
-  data.tar.gz: 25c4703f7327853e8c011505837f714ac5f88d5070af3375bff2a509b2cbeee044b31877def62b503db70b6ea6486262da356600e6b92a8cc28e25561c5bb4ce
+  metadata.gz: c13e0bd5ff9f935997e3977abe7e7e8b257ace6499f0fdc098f8955dc1999ffd36103518e5143c9d3357763f511cb9e5448e8fbb8cc41bc9c7be9ee9493cd432
+  data.tar.gz: '0069c903af37bd0e31ffa14ac4e5901d4f5c19d4ae3ffca36d41dd647196f931bd5d87593b65a158fd25017f75704cf7750f4803a6887e6a41665e6ed3ddda3a'

data/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.0.2] - 2026-09-25
+
+### Changed
+* Update submodule to latest commit ([`f1779be`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/f1779be39697ccea22e9185b0bf57278e8a29707))
+
+* Extract Sherlock Holmes demo to submodule and relocate sample config ([`bfd9e83`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/bfd9e8374753885fece3098cfd00f40606e5d26b))
+
+* Archive completed features 3.2 and 3.3 and streamline audit log ([`39ae7f3`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/39ae7f346dff45828e74fafbfb445420b0d699dd))
+
+
+### Fixed
+* Render language switcher on error pages ([`8e942f9`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/8e942f9fccc23a2c6e097938992c3f23f446bf97))
+
+* Register theme gem in jekyll_plugins group; bump demo submodule ([`392c192`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/392c19209a42f629aba5e1c1e9a2a964832bf0a9))
+
 ## [1.0.1] - 2026-09-24
 
 ### Changed
@@ -357,6 +372,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Initial commit (New Theme Template) ([`00af662`](https://github.com/kmutahar/bilingual-jekyll-resume-theme/commit/00af6628dfec7aefe0ef7d7083bf98c9713a5ffd))
 
+[1.0.2]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.9.0...v1.0.0
 [0.9.0]: https://github.com/kmutahar/bilingual-jekyll-resume-theme/compare/v0.8.0...v0.9.0

data/README.md

@@ -42,9 +42,9 @@ bundle install
 
 ### Basic Setup
 
-1. **Copy sample configuration**: Use `docs/_data/_config.sample.yml` as a starting point for your `_config.yml`. Keep a `languages.<lang>` entry for each language you publish and delete the rest.
+1. **Copy sample configuration**: Use `_config.sample.yml` at the repository root as a starting point for your `_config.yml`. Keep a `languages.<lang>` entry for each language you publish and delete the rest.
 
-2. **Copy sample data files**: Copy each language folder you need from `docs/_data/` (`en`, `ar`, `es`, `fr`, `de`, `ur`) to your site's `_data/`. Each holds 13 files, including `header.yml` for the intro paragraph.
+2. **Copy sample data files**: Copy each language folder you need from `demo/_data/` (`en`, `ar`, `es`, `fr`, `de`, `ur`) to your site's `_data/`. Each holds 13 files, including `header.yml` for the intro paragraph.
 
 3. **Create resume pages**: One page per language, all using the `resume` layout:
 ```yaml
@@ -130,7 +130,7 @@ See the [Configuration Guide](docs/CONFIG_GUIDE.md#3-languages) for every per-la
 
 ### Sample Files
 
-`docs/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all 12 section types. Copy the folders you need to your site.
+`demo/_data/{en,ar,es,fr,de,ur}/` hold a complete Sherlock Holmes demo resume in six languages, covering all 12 section types. Copy the folders you need to your site.
 
 ### Locales
 
@@ -144,18 +144,18 @@ To develop this theme locally:
 # Install dependencies
 bundle install
 
-# Serve the six-language demo (sample config + demo overlay pointing data_dir at docs/_data)
-bundle exec jekyll serve --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+# Serve the six-language demo from the demo submodule
+bundle exec jekyll serve --source demo --destination _site
 
 # Build static output
-bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+bundle exec jekyll build --source demo --destination _site
 
 # Validate resume data schemas and parity (CLI or Rake)
-./bin/validate-resume docs/_data
+./bin/validate-resume demo/_data
 bundle exec rake validate
 
 # Check that the theme's own templates only reference real data keys (CLI or Rake)
-./bin/check-data-keys docs/_data
+./bin/check-data-keys demo/_data
 bundle exec rake check_data_keys
 
 # Validators, RuboCop, and tests together

data/{docs/_data/_config.sample.yml → _config.sample.yml}

@@ -274,6 +274,11 @@ analytics:
 # ==============================================================================
 # Required plugins (bundled as theme runtime dependencies)
 plugins:
+  # Belt-and-suspenders: Jekyll auto-requires gems listed here (site.gems) regardless
+  # of Bundler group, guarding against a Gemfile that forgets to put the theme gem in
+  # the `:jekyll_plugins` group — without that, the build-time resume validator and
+  # HTTP error page generator silently never run.
+  - bilingual-jekyll-resume-theme
   - jekyll-feed
   - jekyll-seo-tag
   - jekyll-sitemap

data/_includes/language-switcher.html

@@ -16,7 +16,7 @@ Include: Reusable Multilingual Language Switcher Component (Feature 1.2; dropdow
 - Toggle: Disabled via site.resume_language_switcher: false in _config.yml.
 {%- endcomment -%}
 
-{% if site.resume_language_switcher != false and page.language_switcher != false and page.layout != 'error' %}
+{% if site.resume_language_switcher != false and page.language_switcher != false %}
   {%- assign current_lang = page.lang | default: site.default_lang | default: 'en' -%}
   {%- assign current_locale = site.data.locales[current_lang] | default: site.data.locales[site.default_lang] -%}
 

data/bin/check-data-keys

@@ -20,7 +20,7 @@ parser = OptionParser.new do |opts|
   opts.separator ""
   opts.separator "Options:"
 
-  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or docs/_data)") do |d|
+  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or demo/_data)") do |d|
     options[:data_dir] = d
   end
 
@@ -51,9 +51,10 @@ parser.parse!
 # Positional argument takes precedence over -d, or fall back to standard data dirs
 data_dir = ARGV[0] || options[:data_dir]
 if data_dir.nil?
-  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's docs sample).
-  data_dir = %w[_data docs/_data].find { |dir| BilingualJekyllResumeTheme::TemplateKeyChecker.new(dir).discover_languages.any? } ||
-             "docs/_data"
+  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's demo).
+  data_dir = %w[_data demo/_data].find do |dir|
+    BilingualJekyllResumeTheme::TemplateKeyChecker.new(dir).discover_languages.any?
+  end || "demo/_data"
 end
 
 checker = BilingualJekyllResumeTheme::TemplateKeyChecker.new(data_dir, config_path: options[:config_path])

data/bin/validate-resume

@@ -22,7 +22,7 @@ parser = OptionParser.new do |opts|
   opts.separator ""
   opts.separator "Options:"
 
-  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or docs/_data)") do |d|
+  opts.on("-d", "--dir DIR", "Path to data directory (default: _data or demo/_data)") do |d|
     options[:data_dir] = d
   end
 
@@ -66,9 +66,10 @@ parser.parse!
 # Positional argument takes precedence over -d, or fall back to standard data dirs
 data_dir = ARGV[0] || options[:data_dir]
 if data_dir.nil?
-  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's docs sample).
-  data_dir = %w[_data docs/_data].find { |dir| BilingualJekyllResumeTheme::ResumeValidator.new(dir).discover_languages.any? } ||
-             "_data"
+  # Prefer a directory that holds at least one language folder (a site's _data, else the theme's demo).
+  data_dir = %w[_data demo/_data].find do |dir|
+    BilingualJekyllResumeTheme::ResumeValidator.new(dir).discover_languages.any?
+  end || "_data"
 end
 
 validator = BilingualJekyllResumeTheme::ResumeValidator.new(

data/docs/ACCESSIBILITY_GUIDE.md

@@ -127,7 +127,7 @@ Run the automated build and verify accessibility attributes:
 
 ```bash
 # Build static site
-bundle exec jekyll build --config docs/_data/_config.sample.yml
+bundle exec jekyll build --source demo --destination _site
 
 # Verify skip link presence
 grep -q 'class="skip-link' _site/index.html && echo "Skip link verified."

data/docs/COMPLETED_AUDIT.md

@@ -1,47 +1,20 @@
 # Completed Historical Remediation & Engineering Audit Log
 
 **Project:** `bilingual-jekyll-resume-theme`  
-**Current Release:** `v1.0.0` (Audited Baseline: `v0.7.0`)  
+**Current Release:** `v1.0.1` (Audited Baseline: `v0.7.0`)  
 **Milestone:** M1 Completed Audit Archival  
 **Audit Date:** September 2026  
 **Master Active Roadmap:** [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md)  
-**Status:** Permanent Historical Record. 18 foundation items (through `v0.7.0`), later completed features, and the four v1.0.0 deliveries (Section 5), all completed and verified
+**Status:** Permanent Historical Record. All foundation items, completed features, and release deliverables are verified in git history and documented in this audit archive.
 
 ---
 
 ## 1. Executive Summary & Audit Overview
 
-This document provides the definitive, permanent engineering record of all **18 bug fixes, security hardenings, data resilience enhancements, accessibility upgrades, and architectural feature deliverables** completed across the `bilingual-jekyll-resume-theme` repository up through release `v0.7.0`. While the current project release has advanced to `v1.0.0`, this document is preserved as the immutable historical record of the 18 foundation remediations.
+This document provides the definitive, permanent engineering record of all **bug fixes, security hardenings, data resilience enhancements, accessibility upgrades, and architectural feature deliverables** completed across the `bilingual-jekyll-resume-theme` repository. It serves as the immutable historical record of foundation remediations and completed features across releases.
 
 To maintain strict hygiene in the active roadmap and eliminate document drift across planning cycles, completed items have been permanently retired from the active roadmap phases and archived in this audit document. For the active, forward-looking engineering roadmap detailing upcoming uncompleted features across Priorities 1 through 4, refer to the authoritative master roadmap at [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md).
 
-### 1.1 Remediation Metrics & Completion Summary
-
-| Scope Phase | Total Audited | Completed & Verified | Completion Rate | Releases Delivered |
-|---|---|---|---|---|
-| **Priority 0 (Immediate Stability, Correctness & Security)** | 16 | 16 | **100%** | `v0.4.0`, `v0.7.0` |
-| **Priority 1 (Visual Enhancements & Quick Wins)** | 2 (P1.2, P1.4) | 2 | **100%** | `v0.7.0`, `v0.8.0` |
-| **Priority 2 (Core Functional & Architecture)** | 3 (P2.4, P2.7, #216) | 3 | **100%** | `v0.7.0`, `v0.8.0` |
-| **Total Completed Engineering Deliverables** | **21** | **21** | **100%** | `v0.4.0` – `v0.8.0` |
-| **v1.0.0 Roadmap Features (1.7, 2.8, 4.1, 4.6)** | 4 | 4 | **100%** | `v1.0.0` (on `feature/extended-multilingual-v1.0.0`, unreleased) |
-
-### 1.2 Categorical Remediation Distribution
-
-```
-+-------------------------------------------------------------+
-| Category Distribution of 21 Completed Items                 |
-+-------------------------------------------------------------+
-| Bug / Logic Fixes:              4 items (P0.1, P0.2, P0.3, P0.9)
-| Security & HTML Correctness:    2 items (P0.5, P0.7)
-| Data Resilience & Optionality:  3 items (P0.13, P0.14, P0.15)
-| Accessibility (WCAG 2.1/2.2):   3 items (P0.10, P1.4, P2.7)
-| RTL & Internationalization:     4 items (P0.8, P0.11, P1.4, P1.2)
-| Architecture & Navigation:      4 items (P0.4, P0.16, P2.4, #216)
-| Asset Management & 404s:        1 item  (P0.6)
-| Governance & Versioning:        1 item  (P0.12)
-+-------------------------------------------------------------+
-```
-
 ---
 
 ## 2. Master Completed Remediation Matrix
@@ -73,6 +46,10 @@ To maintain strict hygiene in the active roadmap and eliminate document drift ac
 | **F2.8** | Header Contact Icon and Text Alignment in Arabic Layout | Issue [#217](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/217) | RTL / a11y | `v1.0.0` | `315356972b326d9fcd5ff58e0208da9a2140116f` | `_layouts/resume-ar.html` (carried into `_layouts/resume.html`) |
 | **F4.1** | Extended Multilingual Support (EN, AR, ES, FR, DE, UR) | Issue [#15](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/15) | i18n / Architecture | `v1.0.0` | `54b40a4`, `3e840a7`, `5058532`, `c37df29`, `da2cd74`, `3f467fe`, `5188e96` | `_data/locales/*.yml`, `_layouts/resume.html`, `_includes/resume-section.html`, `_includes/date-formatter.html`, `_sass/_resume-ltr.scss`, `assets/css/cv-{ltr,rtl}.scss`, every locale consumer, `docs/_data/`, `docs/demo/` |
 | **F4.6** | Deprecation Retirement & Legacy Fallbacks Cleanup | Issue [#214](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/214) | Cleanup / Config | `v1.0.0` | `2c88adf75c915cb682634ac0c98a2211caedb101` | `_includes/avatar.html`, `_includes/analytics-head.html`, `_includes/resume-section.html` |
+| **F3.2** | Automated CI/CD Build & Verification Pipeline | Issue [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | CI/CD | `v1.0.0` | `3be935f` | `.github/workflows/ci.yml`, `.github/workflows/lint.yml`, `README.md` |
+| **F3.3** | YAML Resume Data Validator & Schema Linter | Issue [#13](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/13) | Tooling / Quality | `v1.0.0` | `3be935f` | `bin/validate-resume`, `lib/bilingual-jekyll-resume-theme/resume_validator.rb`, `_plugins/resume_validator.rb`, `docs/VALIDATION_GUIDE.md`, `test/test_resume_validator.rb` |
+| **F2.11** | Pin Language-Switcher/Dark-Mode-Toggle to Fixed Corners (Remove RTL Mirror) | Issue [#227](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/227) | Layout / RTL | `v1.0.1` | `305408c` | `_sass/_layout.scss`, `_sass/_dark-mode.scss`, `_sass/_resume-rtl.scss`, `test/test_language_switcher.rb`, `docs/INCLUDES_GUIDE.md` |
+| **F2.12** | Dropdown Language Switcher (Replace Per-Language Button Row) | Issue [#228](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/228) | i18n / a11y | `v1.0.1` | `f37c6f6` | `_includes/language-switcher.html`, `_sass/_layout.scss`, `test/test_language_switcher.rb`, `docs/INCLUDES_GUIDE.md`, `docs/ACCESSIBILITY_GUIDE.md`, `docs/PROJECT_OVERVIEW.md` |
 
 ---
 
@@ -603,9 +580,9 @@ To maintain strict hygiene in the active roadmap and eliminate document drift ac
 
 ---
 
-## 5. v1.0.0 Delivered Features (1.7, 2.8, 4.1, 4.6)
+## 5. v1.0.0 Delivered Features (1.7, 2.8, 3.2, 3.3, 4.1, 4.6)
 
-The v1.0.0 multilingual release was executed on branch `feature/extended-multilingual-v1.0.0` from an implementation plan that has since been retired; this section, [`../CHANGELOG.md`](../CHANGELOG.md), and [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) are its permanent record. v1.0.0 is a hard break with no compatibility aliases; the full removed-to-replacement table is in [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100). Features 3.2 (CI pipeline, #206) and 3.3 (validator, #13) were implemented on the same branch but stay in the active roadmap until their closure checks pass.
+The v1.0.0 multilingual release was executed on branch `feature/extended-multilingual-v1.0.0` from an implementation plan that has since been retired; this section, [`../CHANGELOG.md`](../CHANGELOG.md), and [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) are its permanent record. v1.0.0 is a hard break with no compatibility aliases; the full removed-to-replacement table is in [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100). All deliverables, including the CI/CD pipeline (#206) and the validator (#13), are verified live and permanently archived here.
 
 ### 5.1 Feature 1.7: Native Email Support in Social Links Include (#215)
 
@@ -638,35 +615,65 @@ The v1.0.0 multilingual release was executed on branch `feature/extended-multili
 - **Delivered:** Removed the `site.avatar` fallback from `_includes/avatar.html`, the `analytics.ga` Universal Analytics branch from `_includes/analytics-head.html`, and the singular `resume_section.recognition` fallback (dropped in `_includes/resume-section.html`). Confirmed `site.resume_dark_mode` and `site.resume_header_intro` have no remaining references.
 - **Commit:** `2c88adf75c915cb682634ac0c98a2211caedb101` (`chore(cleanup): purge deprecated site.avatar, analytics.ga, and resume_dark_mode fallbacks`).
 
+### 5.5 Feature 3.2: Automated CI/CD Build & Verification Pipeline (#206)
+
+- **Problem:** Absence of automated continuous integration allowed invalid front-matter, broken YAML data, or gem specification packaging defects to reach consumers unnoticed.
+- **Delivered:** Configured `.github/workflows/ci.yml` matrix testing across modern Ruby releases (3.3, 3.4, 4.0), strict Jekyll demo build, RuboCop, unit test execution, and gem packaging verification. Added `.github/workflows/lint.yml` and CI status badge to `README.md`.
+- **Commit:** `3be935f` (carried in from `feature/resume-validator-ecosystem`, verified live on PR #220).
+
+### 5.6 Feature 3.3: YAML Resume Data Validator & Schema Linter (#13)
+
+- **Problem:** Non-technical user errors in YAML syntax (missing fields, wrong data types, malformed dates, cross-locale file asymmetries) resulted in cryptic Liquid build failures.
+- **Delivered:** Standalone CLI tool `bin/validate-resume` and core engine `lib/bilingual-jekyll-resume-theme/resume_validator.rb` validating all 13 standard resume files, date formats, active flags, and multi-locale parity. Includes build-time Jekyll plugin `_plugins/resume_validator.rb`, Rake task `rake validate`, comprehensive guide `docs/VALIDATION_GUIDE.md`, and full Minitest suite `test/test_resume_validator.rb`.
+- **Commit:** `3be935f` (carried in from `feature/resume-validator-ecosystem`, verified live on PR #220).
+
+---
+
+## 6. v1.0.1 Delivered Features (2.11, 2.12)
+
+The v1.0.1 maintenance release addressed two visual widget improvements scoped together before v1.0.0. Both were verified against live LTR and RTL builds and merged directly into `master`.
+
+### 6.1 Feature 2.11: Pin Language-Switcher/Dark-Mode-Toggle to Fixed Corners (#227)
+
+- **Problem:** `.language-switcher` and `.dark-mode-toggle` previously swapped top-left/top-right corners based on `locale.direction`, with mirror rules duplicated across `_sass/_layout.scss`, `_sass/_dark-mode.scss`, and `_sass/_resume-rtl.scss`.
+- **Delivered:** Pinned `.language-switcher` fixed to top-left and `.dark-mode-toggle` fixed to top-right across all locales (LTR and RTL), removing all three RTL override locations. Verified against live `ar/cv/` and `ur/cv/` builds at desktop and mobile widths confirming no collision with right-aligned Arabic header titles.
+- **Commit:** `305408c8885c194ad71d88831179b287d4a10ec3` (`feat(layout): pin language-switcher/dark-mode-toggle to fixed corners (Closes #227)`).
+
+### 6.2 Feature 2.12: Dropdown Language Switcher (#228)
+
+- **Problem:** `_includes/language-switcher.html` rendered one button per configured language in a flat row, taking excessive horizontal space and wrapping across multiple rows on mobile screens as locales increased.
+- **Delivered:** Replaced the button row with a semantic `<details>/<summary>` disclosure element wrapping a `<nav>` landmark of per-language links with zero new JavaScript. Preserves full no-JS graceful degradation, keyboard navigation (Tab, Enter/Space, Esc), and accessible screen-reader states.
+- **Commit:** `f37c6f6b410f5de4841ed36115db60408c805293` (`feat(i18n): replace language-switcher button row with a dropdown (Closes #228)`).
+
 ---
 
-## 6. Verification Protocols & Independent Audit Attestation
+## 7. Verification Protocols & Independent Audit Attestation
 
 The following independent verification commands confirm the integrity of the codebase following the completion of all 18 remediation tasks:
 
-### 6.1 RubyGem Packaging Verification
+### 7.1 RubyGem Packaging Verification
 ```bash
 gem build bilingual-jekyll-resume-theme.gemspec
 ```
 *Passing Result:* Successfully built RubyGem `bilingual-jekyll-resume-theme-0.7.0.gem` with zero packaging errors. All new files (`404.html`, `403.html`, `500.html`, `_layouts/error.html`, `_data/error_pages.yml`, `_includes/avatar.html`) are verified in the gem manifest.
 
-### 6.2 Liquid Syntax & Template Tag Inspection
+### 7.2 Liquid Syntax & Template Tag Inspection
 All modified templates (`_layouts/resume-ar.html`, `_layouts/resume-en.html`, `_layouts/default.html`, `_layouts/error.html`, `_includes/analytics-body.html`, `_includes/analytics-head.html`, `_includes/avatar.html`, `_includes/resume-section-*.html`, `_includes/shared-head.html`, `_includes/social-links.html`, `_includes/print-social-links.html`) contain valid, balanced Liquid tags and conform to Jekyll 3.9+ / 4.x standards.
 
-### 6.3 WCAG 2.1 AA Accessibility Attestation
+### 7.3 WCAG 2.1 AA Accessibility Attestation
 - All social links contain `aria-label`, `title`, and visually-hidden `<span class="sr-only">` text.
 - All SVG icons contain `aria-hidden="true" focusable="false"`.
 - Avatar image component includes bilingual fallback alt text, Schema.org `itemprop="image"`, and accessible link targets.
 
-### 6.4 RTL & Bidirectional Text Isolation Attestation
+### 7.4 RTL & Bidirectional Text Isolation Attestation
 - Arabic templates enforce `dir="rtl"` root direction with `<span dir="ltr">` isolation for telephone links, URLs, and printed social links.
 - Arabic Google Font Cairo loads reliably across all themes and custom palettes with preconnect hints.
 
 ---
 
-## 7. Closed Redundant Duplicate Issues Registry & Root Cause Analysis
+## 8. Closed Redundant Duplicate Issues Registry & Root Cause Analysis
 
-### 7.1 Duplicate Creation Root Cause Analysis (RCA)
+### 8.1 Duplicate Creation Root Cause Analysis (RCA)
 
 Between `2026-09-12T11:37:00Z` and `2026-09-12T12:10:49Z`, an automated script executed 13 successive batch sweeps across the repository issue tracker. In each cycle, a batch of 14 items was generated:
 1. 11 remediation items corresponding to Phase 0 bug fixes (P0.1–P0.11): immediately closed upon creation.
@@ -681,9 +688,9 @@ Because 13 successive batch runs were triggered, 13 identical copies of the Soci
 
 The 13th batch produced `#204` and `#206`, which are designated as the **canonical active open issues** in [`/FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md). All preceding 24 issues were formally closed on GitHub using GitHub's native `state_reason: "duplicate"` linking to `#204` and `#206`, preceded by an explanatory cross-reference comment.
 
-### 7.2 Social Media Platform Closed Duplicates (12 Issues)
+### 8.2 Social Media Platform Closed Duplicates
 
-All 12 duplicate issues share the title `"Expand Social Media Platforms (Mastodon, Discord, Bluesky, etc.)"`, labels `["enhancement", "phase-1"]`, and milestone `"Phase 1 (Quick Wins - 1-2 weeks)"`.
+The duplicate issues share the title `"Expand Social Media Platforms (Mastodon, Discord, Bluesky, etc.)"`, labels `["enhancement", "phase-1"]`, and milestone `"Phase 1 (Quick Wins - 1-2 weeks)"`.
 
 | Issue # | Title | Created (UTC) | Closed (UTC) | Status | Canonical Reference | Resolution Details |
 |---|---|---|---|---|---|---|
@@ -700,9 +707,9 @@ All 12 duplicate issues share the title `"Expand Social Media Platforms (Mastodo
 | [#176](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/176) | Expand Social Media Platforms | 2026-09-12T12:05:43Z | 2026-09-12T14:06:23Z | `CLOSED (duplicate)` | [#204](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/204) | Closed via GitHub API with cross-reference comment to #204 |
 | [#190](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/190) | Expand Social Media Platforms | 2026-09-12T12:08:26Z | 2026-09-12T14:06:35Z | `CLOSED (duplicate)` | [#204](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/204) | Closed via GitHub API with cross-reference comment to #204 |
 
-### 7.3 CI/CD Pipeline Closed Duplicates (12 Issues)
+### 8.3 CI/CD Pipeline Closed Duplicates
 
-All 12 duplicate issues share the title `"Automated CI/CD Build & Verification Pipeline"`, labels `["enhancement", "phase-3"]`, and milestone `"Phase 3 (Long-term - 2-3 months)"`.
+The duplicate issues share the title `"Automated CI/CD Build & Verification Pipeline"`, labels `["enhancement", "phase-3"]`, and milestone `"Phase 3 (Long-term - 2-3 months)"`.
 
 | Issue # | Title | Created (UTC) | Closed (UTC) | Status | Canonical Reference | Resolution Details |
 |---|---|---|---|---|---|---|
@@ -719,7 +726,7 @@ All 12 duplicate issues share the title `"Automated CI/CD Build & Verification P
 | [#178](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/178) | Automated CI/CD Build & Pipeline | 2026-09-12T12:05:54Z | 2026-09-12T14:08:45Z | `CLOSED (duplicate)` | [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | Closed via GitHub API with cross-reference comment to #206 |
 | [#192](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/192) | Automated CI/CD Build & Pipeline | 2026-09-12T12:08:37Z | 2026-09-12T14:08:57Z | `CLOSED (duplicate)` | [#206](https://github.com/kmutahar/bilingual-jekyll-resume-theme/issues/206) | Closed via GitHub API with cross-reference comment to #206 |
 
-### 7.4 Closing Comment Audit Trail
+### 8.4 Closing Comment Audit Trail
 
 Each duplicate issue received a courteous explanatory comment before closure on GitHub:
 - **Social Media Comment:**
@@ -733,7 +740,7 @@ Each duplicate issue received a courteous explanatory comment before closure on
 
 ---
 
-## 8. Pull Requests & Ancillary GitHub Records
+## 9. Pull Requests & Ancillary GitHub Records
 
 | PR # | Status | Title | Description | Resolution |
 |---|---|---|---|---|

data/docs/CONFIG_GUIDE.md

@@ -1,6 +1,6 @@
 # Configuration Guide (`_config.yml`)
 
-Every setting the theme reads from a consuming site's `_config.yml`. The annotated master copy is [`_data/_config.sample.yml`](_data/_config.sample.yml); when this guide and that file disagree, the sample file is the one the build uses.
+Every setting the theme reads from a consuming site's `_config.yml`. The annotated master copy is [`_config.sample.yml`](../_config.sample.yml); when this guide and that file disagree, the sample file is the one the build uses.
 
 Per-language settings (name, title, address, data path, URL) live under `languages.<lang>`. Direction, fonts, and UI strings are not config at all: they come from `_data/locales/<lang>.yml` (see [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md)). Upgrading from v0.9.0? The key-by-key migration table is in [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md#breaking-changes--migration-v090-to-v100).
 
@@ -29,7 +29,7 @@ Per-language settings (name, title, address, data path, URL) live under `languag
 ## Quick Start
 
 > [!TIP]
-> Copy [`_data/_config.sample.yml`](_data/_config.sample.yml) to your site root as `_config.yml`. Starter resume data for six languages is in [`_data/`](_data/) (`en`, `ar`, `es`, `fr`, `de`, `ur`).
+> Copy [`_config.sample.yml`](../_config.sample.yml) to your site root as `_config.yml`. Starter resume data for six languages is available in the [`demo/_data/`](../demo/_data/) directory (`en`, `ar`, `es`, `fr`, `de`, `ur`).
 >
 > **System Requirements:** Ruby >= 3.3.0 (maintained on Ruby 3.3, 3.4, and 4.0) and Jekyll >= 4.4.0. Declare the gem inside `group :jekyll_plugins` in your `Gemfile`, or the error page generator and build-time validation never load.
 

data/docs/MULTILINGUAL_GUIDE.md

@@ -125,9 +125,9 @@ The validator builds each locale the same way (theme file, then site file deep-m
 - Keep proper nouns consistent: transliterate them in non-Latin scripts and keep them as-is in Latin-script languages.
 - Write dates as ISO (`YYYY-MM-DD`, `YYYY-MM`, or `YYYY`). Month names come from the locale file, so the data stays language-neutral.
 - For ongoing roles, leave `enddate` blank or use any value from that locale's `present_values`.
-- The Sherlock Holmes demo in [`_data/`](_data/) (`en`, `ar`, `es`, `fr`, `de`, `ur`) is a complete, parity-clean reference. Build it from the repository root with:
+- The Sherlock Holmes demo in [`demo/_data/`](../demo/_data/) (`en`, `ar`, `es`, `fr`, `de`, `ur`) is a complete, parity-clean reference. Build it from the repository root with:
   ```bash
-  bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+  bundle exec jekyll build --source demo --destination _site
   ```
 
 ---

data/docs/PROJECT_OVERVIEW.md

@@ -52,16 +52,16 @@ Sections render in the order of `site.resume_section_order` through one dispatch
 | Need / Task | Go To | Verification Method |
 |---|---|---|
 | Configure site settings, languages, avatar, or analytics | `_config.yml`, [`CONFIG_GUIDE.md`](CONFIG_GUIDE.md) | Demo build (below) |
-| Add a language or change UI strings, fonts, or month names | `_data/locales/<lang>.yml`, [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) | `./bin/validate-resume docs/_data`, then inspect `_site/<lang>/cv/` |
-| Modify resume section data | `_data/<lang>/*.yml`, [`DATA_GUIDE.md`](DATA_GUIDE.md) | `./bin/validate-resume docs/_data` |
+| Add a language or change UI strings, fonts, or month names | `_data/locales/<lang>.yml`, [`MULTILINGUAL_GUIDE.md`](MULTILINGUAL_GUIDE.md) | `./bin/validate-resume demo/_data`, then inspect `_site/<lang>/cv/` |
+| Modify resume section data | `_data/<lang>/*.yml`, [`DATA_GUIDE.md`](DATA_GUIDE.md) | `./bin/validate-resume demo/_data` |
 | Customize error pages or return URLs | `_layouts/error.html`, `_plugins/error_pages_generator.rb`, `error_pages` in the locale files, [`LAYOUTS_GUIDE.md`](LAYOUTS_GUIDE.md) | Inspect `_site/404.html`, `_site/500.html` |
 | Adjust dark mode colors or tokens | `_sass/_dark-mode.scss`, [`SASS_GUIDE.md`](SASS_GUIDE.md) | Inspect CSS variables on `:root` and `[data-theme="dark"]` |
 | Adjust RTL mirroring | `_sass/_resume-rtl.scss`, [`SASS_GUIDE.md`](SASS_GUIDE.md) | Inspect `_site/ar/cv/` and `_site/ur/cv/` |
 
-Demo build (renders the six-language Sherlock Holmes resume from `docs/`):
+Demo build (renders the six-language Sherlock Holmes resume from the `demo/` submodule):
 
 ```bash
-bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+bundle exec jekyll build --source demo --destination _site
 ```
 
 ---
@@ -144,12 +144,7 @@ bilingual-jekyll-resume-theme/
     ├── MULTILINGUAL_GUIDE.md     # Locales, adding languages, v1.0.0 migration table
     ├── SASS_GUIDE.md             # Styling system, tokens, RTL
     ├── VALIDATION_GUIDE.md       # Validator, CLI, CI, proofing
-    ├── PROJECT_OVERVIEW.md       # This file
-    ├── demo/                     # Six demo resume pages (layout: resume)
-    └── _data/
-        ├── _config.sample.yml    # Master sample configuration
-        ├── _config.demo.yml      # Demo overlay (data_dir: docs/_data, Sherlock Holmes persona)
-        └── en/ ar/ es/ fr/ de/ ur/  # Sherlock Holmes demo data, 13 files each
+    └── PROJECT_OVERVIEW.md       # This file
 ```
 
 ---
@@ -169,4 +164,4 @@ bilingual-jekyll-resume-theme/
 | **Completed Audit** | [`COMPLETED_AUDIT.md`](COMPLETED_AUDIT.md) | Historical record of completed fixes and features |
 | **Master AI Manual** | [`../AGENTS.md`](../AGENTS.md) | Operating rules for AI agents |
 | **Feature Roadmap** | [`../FEATURE_ROADMAP.md`](../FEATURE_ROADMAP.md) | Active feature blueprints, issue mappings, Delete-Zone |
-| **Sample Config** | [`_data/_config.sample.yml`](_data/_config.sample.yml) | Annotated configuration for consuming sites |
+| **Sample Config** | [`../_config.sample.yml`](../_config.sample.yml) | Annotated configuration for consuming sites |

data/docs/VALIDATION_GUIDE.md

@@ -66,14 +66,14 @@ The gem installs `validate-resume` as an executable. In a consuming site run it
 bundle exec validate-resume                       # auto-detects the data directory
 bundle exec validate-resume _data                 # explicit data directory
 bundle exec validate-resume _data -c _config.yml  # explicit config
-./bin/validate-resume docs/_data                  # this repository's six-language demo
+./bin/validate-resume demo/_data                  # this repository's six-language demo
 ```
 
-With no `DATA_DIR`, the CLI uses the first of `_data` and `docs/_data` that contains at least one language folder, else `_data`. A positional `DATA_DIR` wins over `-d`.
+With no `DATA_DIR`, the CLI uses the first of `_data` and `demo/_data` that contains at least one language folder, else `_data`. A positional `DATA_DIR` wins over `-d`.
 
 | Flag | Long flag | Description | Default |
 |---|---|---|---|
-| `-d DIR` | `--dir DIR` | Data directory | `_data` or `docs/_data` |
+| `-d DIR` | `--dir DIR` | Data directory | `_data` or `demo/_data` |
 | `-c FILE` | `--config FILE` | Jekyll config that declares `languages:` | First config found next to the data directory ([section 2](#2-how-languages-and-locales-are-resolved)) |
 | `-l LANGS` | `--languages LANGS` | Comma-separated languages to validate; overrides the config | The config's `languages:` |
 | `-a` | `--all-locales` | Also validate every language folder found by directory scan | off |
@@ -90,7 +90,7 @@ Exit codes: `0` when there are no errors (and no warnings under `-w`), `1` other
 ## 4. Rake Task (`rake validate`)
 
 ```bash
-bundle exec rake validate               # _data if _data/en exists, else docs/_data
+bundle exec rake validate               # _data if _data/en exists, else demo/_data
 bundle exec rake "validate[path/to/_data]"
 ```
 
@@ -193,7 +193,7 @@ Add the scheme, for example `https://github.com/user`.
 
 This repository runs the validator (and the template key checker, [section 11](#11-template-key-checker-check-data-keys)) in two workflows:
 
-- [`.github/workflows/lint.yml`](../.github/workflows/lint.yml): `./bin/validate-resume docs/_data --fail-on-warnings`, `rake validate[docs/_data]`, `./bin/check-data-keys docs/_data`, `rake check_data_keys[docs/_data]`, a gemspec executable check, and RuboCop.
+- [`.github/workflows/lint.yml`](../.github/workflows/lint.yml): `./bin/validate-resume demo/_data --fail-on-warnings`, `rake validate[demo/_data]`, `./bin/check-data-keys demo/_data`, `rake check_data_keys[demo/_data]`, a gemspec executable check, and RuboCop.
 - [`.github/workflows/ci.yml`](../.github/workflows/ci.yml): gem packaging, a strict Jekyll build, built-HTML proofing, both checkers, and the unit tests across Ruby 3.3, 3.4, and 4.0.
 
 A consuming site can run the same check on every push:
@@ -222,7 +222,7 @@ Two development-only Rake tasks complement the data validator. Their gems are de
 
 ```bash
 # Dead internal links, broken #anchors, missing images/favicons, hreflang/canonical targets.
-bundle exec jekyll build --config docs/_data/_config.sample.yml,docs/_data/_config.demo.yml
+bundle exec jekyll build --source demo --destination _site
 bundle exec rake proof                                   # proofs ./_site
 
 # Proof a consuming site (config auto-detected next to its _site/, or passed explicitly):
@@ -246,15 +246,15 @@ bundle exec rake rubocop
 Because "known keys" are derived from whatever the checked sample data actually contains, a field a template correctly references but that no language in the checked data happens to exercise (an optional field, e.g. `education.yml`'s `awards` list) will warn even though nothing is wrong. For this reason `check-data-keys` **never defaults to `--fail-on-warnings` in this repository's Rake task or CI steps**, unlike `validate-resume`. Warnings are printed and worth reading, but a warning alone does not mean the template is broken — cross-check against the field before "fixing" it.
 
 ```bash
-./bin/check-data-keys docs/_data                  # this repository's six-language demo (the default target)
-./bin/check-data-keys docs/_data --fail-on-warnings  # opt into strict mode yourself, once you trust your data's coverage
-bundle exec rake check_data_keys                     # docs/_data by default
+./bin/check-data-keys demo/_data                  # this repository's six-language demo (the default target)
+./bin/check-data-keys demo/_data --fail-on-warnings  # opt into strict mode yourself, once you trust your data's coverage
+bundle exec rake check_data_keys                     # demo/_data by default
 bundle exec rake "check_data_keys[path/to/_data]"
 ```
 
 | Flag | Long flag | Description | Default |
 |---|---|---|---|
-| `-d DIR` | `--dir DIR` | Data directory | `_data` or `docs/_data` |
+| `-d DIR` | `--dir DIR` | Data directory | `_data` or `demo/_data` |
 | `-c FILE` | `--config FILE` | Jekyll config that declares `languages:` | First config found next to the data directory ([section 2](#2-how-languages-and-locales-are-resolved)) |
 | `-w` | `--fail-on-warnings` | Exit 1 on warnings | off |
 | `-v` | `--verbose` | Verbose output | off |

data/lib/bilingual-jekyll-resume-theme/template_key_checker.rb

@@ -62,7 +62,7 @@ module BilingualJekyllResumeTheme
     # template_root: overrides where _layouts/_includes are scanned from (default:
     # this gem's own root). Exists so tests can point the Liquid-tracing logic at
     # synthetic fixture templates instead of the theme's real ones.
-    def initialize(data_dir = "docs/_data", config_path: nil, config: nil, template_root: THEME_ROOT)
+    def initialize(data_dir = "_data", config_path: nil, config: nil, template_root: THEME_ROOT)
       @data_dir = data_dir.to_s.chomp("/")
       @config_path = config_path
       @config = config

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bilingual-jekyll-resume-theme
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Khaldoon Mutahar
@@ -178,6 +178,7 @@ files:
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
+- _config.sample.yml
 - _data/locales/ar.yml
 - _data/locales/de.yml
 - _data/locales/en.yml
@@ -256,93 +257,6 @@ files:
 - docs/PROJECT_OVERVIEW.md
 - docs/SASS_GUIDE.md
 - docs/VALIDATION_GUIDE.md
-- docs/_data/_config.demo.yml
-- docs/_data/_config.sample.yml
-- docs/_data/ar/associations.yml
-- docs/_data/ar/certifications.yml
-- docs/_data/ar/courses.yml
-- docs/_data/ar/education.yml
-- docs/_data/ar/experience.yml
-- docs/_data/ar/header.yml
-- docs/_data/ar/interests.yml
-- docs/_data/ar/languages.yml
-- docs/_data/ar/links.yml
-- docs/_data/ar/projects.yml
-- docs/_data/ar/recognitions.yml
-- docs/_data/ar/skills.yml
-- docs/_data/ar/volunteering.yml
-- docs/_data/de/associations.yml
-- docs/_data/de/certifications.yml
-- docs/_data/de/courses.yml
-- docs/_data/de/education.yml
-- docs/_data/de/experience.yml
-- docs/_data/de/header.yml
-- docs/_data/de/interests.yml
-- docs/_data/de/languages.yml
-- docs/_data/de/links.yml
-- docs/_data/de/projects.yml
-- docs/_data/de/recognitions.yml
-- docs/_data/de/skills.yml
-- docs/_data/de/volunteering.yml
-- docs/_data/en/associations.yml
-- docs/_data/en/certifications.yml
-- docs/_data/en/courses.yml
-- docs/_data/en/education.yml
-- docs/_data/en/experience.yml
-- docs/_data/en/header.yml
-- docs/_data/en/interests.yml
-- docs/_data/en/languages.yml
-- docs/_data/en/links.yml
-- docs/_data/en/projects.yml
-- docs/_data/en/recognitions.yml
-- docs/_data/en/skills.yml
-- docs/_data/en/volunteering.yml
-- docs/_data/es/associations.yml
-- docs/_data/es/certifications.yml
-- docs/_data/es/courses.yml
-- docs/_data/es/education.yml
-- docs/_data/es/experience.yml
-- docs/_data/es/header.yml
-- docs/_data/es/interests.yml
-- docs/_data/es/languages.yml
-- docs/_data/es/links.yml
-- docs/_data/es/projects.yml
-- docs/_data/es/recognitions.yml
-- docs/_data/es/skills.yml
-- docs/_data/es/volunteering.yml
-- docs/_data/fr/associations.yml
-- docs/_data/fr/certifications.yml
-- docs/_data/fr/courses.yml
-- docs/_data/fr/education.yml
-- docs/_data/fr/experience.yml
-- docs/_data/fr/header.yml
-- docs/_data/fr/interests.yml
-- docs/_data/fr/languages.yml
-- docs/_data/fr/links.yml
-- docs/_data/fr/projects.yml
-- docs/_data/fr/recognitions.yml
-- docs/_data/fr/skills.yml
-- docs/_data/fr/volunteering.yml
-- docs/_data/ur/associations.yml
-- docs/_data/ur/certifications.yml
-- docs/_data/ur/courses.yml
-- docs/_data/ur/education.yml
-- docs/_data/ur/experience.yml
-- docs/_data/ur/header.yml
-- docs/_data/ur/interests.yml
-- docs/_data/ur/languages.yml
-- docs/_data/ur/links.yml
-- docs/_data/ur/projects.yml
-- docs/_data/ur/recognitions.yml
-- docs/_data/ur/skills.yml
-- docs/_data/ur/volunteering.yml
-- docs/assets/images/sherlock-holmes.jpg
-- docs/demo/ar.md
-- docs/demo/de.md
-- docs/demo/en.md
-- docs/demo/es.md
-- docs/demo/fr.md
-- docs/demo/ur.md
 - lib/bilingual-jekyll-resume-theme.rb
 - lib/bilingual-jekyll-resume-theme/resume_validator.rb
 - lib/bilingual-jekyll-resume-theme/template_key_checker.rb