imagewize · jasperf · Dec 11, 2025 · Dec 11, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,23 @@ All notable changes to the Moiraine WordPress theme will be documented in this f
 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).
 
+## [3.0.2] - 2025-12-11
+
+### Changed - Documentation Clarity
+
+**README Updates:**
+- **Clarified theme relationship**: Updated README to accurately describe Moiraine as "built on the foundation of Ollie" rather than a "child theme"
+- **Dependency transparency**: Added explicit statement that ~65-70% of Moiraine's base code comes from Ollie (pattern layouts, templates, block styles)
+- **Original contributions highlighted**: Documented Moiraine's extensions including 16 original patterns, custom block extensions (230+ lines PHP), 22 block-specific stylesheets, enhanced navigation, WooCommerce integration, and production tooling
+- **Credits section expanded**: Detailed breakdown in Credits section showing what comes from Ollie vs. what Moiraine adds
+- **Getting Started simplified**: Removed confusing "child theme" download link, streamlined to single Moiraine repository link
+
+**Why Changed:**
+- Moiraine is a substantial fork/evolution of Ollie, not a traditional WordPress child theme
+- All 34 shared patterns are customized versions with Moiraine namespace, content, and styling
+- Transparency about code origins while highlighting significant original work (30-35% new code)
+- Better reflects the actual technical relationship between the themes
+
 ## [3.0.1] - 2025-12-11
 
 ### Added - Layout Template Patterns Restored

diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 </div>
 
 
-Moiraine is a WordPress block theme child theme of [Ollie](https://github.com/OllieWP/ollie) designed for the WordPress block editor and site editor. Create beautiful, fully-customizable websites with WordPress's built-in tools — no coding required.
+Moiraine is a WordPress block theme built on the foundation of [Ollie](https://github.com/OllieWP/ollie), designed for the WordPress block editor and site editor. While Moiraine uses Ollie's core architecture (~65-70% of base code including pattern layouts, templates, and block styles), it extends the foundation with significant customizations: 16 original patterns, custom block extensions, WooCommerce integration, enhanced navigation, 22 block-specific stylesheets, and production-grade development tooling. Create beautiful, fully-customizable websites with WordPress's built-in tools — no coding required.
 
 Features **49 professional patterns** (Moiraine-first heroes, CTAs, testimonials, statistics, blog layouts, essential headers/footers, and comprehensive template layouts), WooCommerce integration, modern development tooling, and blazing-fast performance with 100% scores across the board.
 
@@ -22,8 +22,7 @@ Features **49 professional patterns** (Moiraine-first heroes, CTAs, testimonials
 
 | Links  | Description |
 | ------------- | ------------- |
-| [Download Moiraine Theme Zip](https://github.com/OllieWP/ollie/releases/latest/download/ollie.zip)  | Download the latest Moiraine theme zip to install on your WordPress site.  |
-| [Download Moiraine Child Theme Zip](https://github.com/imagewize/moiraine-child)  | Download the Moiraine child theme zip for customizations  |
+| [Download Moiraine Theme](https://github.com/imagewize/moiraine)  | Download the Moiraine theme to install on your WordPress site.  |
 
 Moiraine is built for modern WordPress features and requires WordPress 6.0 or later. To get started, download the theme and install it into your WordPress website by going to `Appearance → Themes → Add New`.
 
@@ -131,7 +130,15 @@ See `CLAUDE.md` for detailed development documentation.
 ## Credits
 
 ### Theme Foundation
-Moiraine is based on the [Ollie theme](https://github.com/OllieWP/ollie) by [Mike McAlister](https://mikemcalister.com). We express our gratitude to Mike for creating such an excellent foundation for WordPress block themes.
+Moiraine is built on the [Ollie theme](https://github.com/OllieWP/ollie) by [Mike McAlister](https://mikemcalister.com). Approximately 65-70% of Moiraine's core architecture comes from Ollie, including:
+- Pattern layouts and template structures (34 of 50 patterns are customized Ollie patterns)
+- Block style variations (13 style variations)
+- Pattern categories and helper functions
+- Base `functions.php` structure and theme setup
+
+All shared code has been adapted with Moiraine's namespace, custom content, and styling. Moiraine extends this foundation with 16 original patterns, custom block extensions (230+ lines of PHP), 22 block-specific stylesheets, enhanced navigation and WooCommerce integration, and production-grade development tooling.
+
+We express our gratitude to Mike for creating such an excellent foundation for WordPress block themes.
 
 ### Additional Credits
 - Favicon: [Ladybug icon](https://blade-ui-kit.com/blade-icons/mdi-ladybug) from Blade UI Kit

diff --git a/readme.txt b/readme.txt
@@ -4,7 +4,7 @@ Tags: blog, portfolio, entertainment, grid-layout, one-column, two-columns, thre
 Requires at least: 5.8
 Tested up to: 6.9
 Requires PHP: 7.3
-Stable tag: 3.0.1
+Stable tag: 3.0.2
 License: GNU General Public License v3.0 (or later)
 License URI: https://www.gnu.org/licenses/gpl-3.0.html
 
@@ -14,6 +14,13 @@ Launch a blazing-fast, pixel-perfect website with the Moiraine WordPress block t
 
 == Changelog ==
 
+= 3.0.2 - 12/11/25 =
+* CHANGED: Documentation Clarity - Updated README to accurately describe Moiraine as "built on the foundation of Ollie" rather than a "child theme"
+* CHANGED: Dependency Transparency - Added explicit statement that ~65-70% of Moiraine's base code comes from Ollie (pattern layouts, templates, block styles)
+* CHANGED: Credits Section Expanded - Detailed breakdown showing what comes from Ollie (34 customized patterns, 13 block styles, helper functions) vs. Moiraine additions (16 original patterns, 230+ lines custom PHP, 22 stylesheets)
+* CHANGED: Getting Started Simplified - Removed confusing "child theme" download link, streamlined to single Moiraine repository link
+* IMPROVED: Transparency - Better reflects actual technical relationship: Moiraine is a substantial fork/evolution of Ollie with significant original work (30-35% new code)
+
 = 3.0.1 - 12/11/25 =
 * ADDED: 11 Essential Template Patterns - Restored layout templates for pages and posts (template-index-list, template-page-404, template-page-archive, template-page-full, template-page-left-sidebar, template-page-right-sidebar, template-page-search, template-page-wide, template-post-left-sidebar, template-post-right-sidebar, template-post-wide)
 * ADDED: Custom Mobile Menu - Maintained menu-panel-1-mobile pattern (custom mobile-optimized menu that doesn't exist in Ollie)

diff --git a/style.css b/style.css
@@ -7,7 +7,7 @@ Description: Launch a blazing-fast, pixel-perfect website with the Moiraine Word
 Tags: blog, portfolio, entertainment, grid-layout, one-column, two-columns, three-columns, four-columns, block-patterns, block-styles, custom-logo, custom-menu, editor-style, featured-images, full-site-editing, full-width-template, rtl-language-support, style-variations, template-editing, theme-options, translation-ready, wide-blocks
 Tested up to: 6.9
 Requires PHP: 7.3
-Version: 3.0.0
+Version: 3.0.2
 License: GNU General Public License v3 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 Text Domain: moiraine