Merge dev → master: v2.0.0 stable release

Production-ready v2.0.0 release with document reading capabilities.

Changes from beta to stable:
- Phase 10: Document Reading (60% complete)
  * OpenDocument() for reading existing .docx files
  * Read/modify document structure (paragraphs, runs, tables)
  * Style preservation for all paragraph styles
  * Example 12: Read and modify documents workflow

- Bug Fixes:
  * Fixed paragraph style preservation in reader
  * Enhanced example 12 with editing capabilities

- Documentation:
  * Fixed README Quick Start API examples
  * Corrected function signatures and constants
  * Updated Phase 10 status to 60% complete
  * Updated example count to 11

- Release Materials:
  * Created RELEASE_NOTES_v2.0.0.md
  * Updated CHANGELOG.md with v2.0.0 section

Commits: 852c3bf...4de1816 (7 commits)
Ready for v2.0.0 tag and GitHub release.

Author: mmonterroca

CHANGELOG.md

@@ -7,7 +7,60 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added (Phase 1 - Foundation)
+### Planned for v2.1.0
+- Complete Phase 10: Document Reading to 100%
+- Read headers/footers from existing documents
+- Read images from existing documents
+- Comments and change tracking
+
+---
+
+## [2.0.0] - 2025-10-29
+
+### 🎉 Production Release - v2.0.0 Stable
+
+This is the first stable, production-ready release of go-docx v2!
+
+### Added - Phase 10: Document Reading (NEW! 60% Complete)
+
+#### Document Reading & Modification
+- **OpenDocument()** - Open and read existing .docx files
+- **Document parsing** - Parse document structure (paragraphs, runs, tables)
+- **Content modification** - Edit existing text, formatting, and table cells
+- **Style preservation** - Maintains all paragraph styles (Title, Subtitle, Heading1-9, Quote, Normal, ListParagraph)
+- **Content addition** - Add new paragraphs, runs, and sections to existing documents
+- **Round-trip workflow** - Create → Save → Open → Modify → Save
+- **Example 12** - Complete read/modify example with documentation
+
+#### Bug Fixes Since Beta
+- **Fixed style preservation** - Paragraph styles now correctly preserved when reading documents (Oct 29, 2025)
+  - Added `applyParagraphStyle()` function in `internal/reader/reconstruct.go`
+  - Extracts `w:pStyle` from paragraph properties and applies via `para.SetStyle()`
+  - All paragraph styles (Title, Subtitle, Heading1-3, Quote, Normal, ListParagraph) now working
+- **Enhanced example 12** - Now demonstrates both editing existing content AND adding new content
+
+#### Documentation Improvements Since Beta
+- **Fixed README Quick Start** - Corrected all API examples to show accurate signatures
+  - Separated Simple API vs Builder API clearly
+  - Fixed `WithDefaultFont()` and `WithDefaultFontSize()` signatures
+  - Corrected page size constant (`docx.A4` not `docx.PageSizeA4`)
+  - Fixed alignment constant (`domain.AlignmentCenter` not `docx.AlignmentCenter`)
+  - Added new Option 3: Read and Modify Existing Documents
+- **Updated example count** - All documentation now references 11 working examples (was 9)
+- **Updated Phase 10 status** - Marked as "60% complete - core features working" (was "Not Started")
+- **Fixed error handling examples** - Corrected builder pattern usage in README
+
+### Commits Since Beta (v2.0.0-beta...v2.0.0)
+- `3a0832a` - docs: fix README Quick Start with correct API examples and update status
+- `19c0e73` - Update documentation: Phase 10 now 60% complete with working reader
+- `ca7f1f1` - Fix: Preserve paragraph styles when reading documents
+- `3289b54` - Enhance example 12: Add content editing capabilities
+- `852c3bf` - Add example 12: Read and modify documents
+- `497a94a` - Fix strict OOXML validation and update docs to beta-ready status
+
+### Summary of v2.0.0 Complete Features
+
+#### Core Features from Beta (Carried Forward)
 - **Core Interfaces** (domain package)
   - `Document` interface with metadata support
   - `Paragraph` interface with full formatting options

README.md

@@ -51,7 +51,7 @@ go get github.com/mmonterroca/docxgo
 
 ## Quick Start
 
-### Using Builder Pattern (Recommended)
+### Option 1: Simple API (Direct Domain Interfaces)
 
 ```go
 package main
@@ -62,31 +62,52 @@ import (
 )
 
 func main() {
-    // Option 1: Simple API (direct domain interfaces)
+    // Create document
     doc := docx.NewDocument()
 
+    // Add paragraph with formatted text
     para, _ := doc.AddParagraph()
     run, _ := para.AddRun()
     run.SetText("Hello, World!")
     run.SetBold(true)
     run.SetColor(docx.Red)
 
-    doc.SaveAs("simple.docx")
-    
-    // Option 2: Builder API (fluent, chainable)
+    // Save document
+    if err := doc.SaveAs("simple.docx"); err != nil {
+        log.Fatal(err)
+    }
+}
+```
+
+### Option 2: Builder API (Fluent, Chainable - Recommended)
+
+```go
+package main
+
+import (
+    "log"
+    docx "github.com/mmonterroca/docxgo"
+    "github.com/mmonterroca/docxgo/domain"
+)
+
+func main() {
+    // Create builder with options
     builder := docx.NewDocumentBuilder(
-        docx.WithDefaultFont("Calibri", 11),
-        docx.WithPageSize(docx.PageSizeA4),
         docx.WithTitle("My Report"),
         docx.WithAuthor("John Doe"),
+        docx.WithDefaultFont("Calibri"),
+        docx.WithDefaultFontSize(22), // 11pt in half-points
+        docx.WithPageSize(docx.A4),
+        docx.WithMargins(docx.NormalMargins),
     )
 
     // Add content using fluent API
     builder.AddParagraph().
         Text("Project Report").
         Bold().
         FontSize(16).
-        Alignment(docx.AlignmentCenter).
+        Color(docx.Blue).
+        Alignment(domain.AlignmentCenter).
         End()
 
     builder.AddParagraph().
@@ -107,15 +128,58 @@ func main() {
 }
 ```
 
+### Option 3: Read and Modify Existing Documents 🆕
+
+```go
+package main
+
+import (
+    "log"
+    docx "github.com/mmonterroca/docxgo"
+)
+
+func main() {
+    // Open existing document
+    doc, err := docx.OpenDocument("template.docx")
+    if err != nil {
+        log.Fatal(err)
+    }
+    
+    // Read existing content
+    paragraphs := doc.Paragraphs()
+    for _, para := range paragraphs {
+        // Modify existing text
+        runs := para.Runs()
+        for _, run := range runs {
+            if run.Text() == "PLACEHOLDER" {
+                run.SetText("Updated Value")
+                run.SetBold(true)
+            }
+        }
+    }
+    
+    // Add new content
+    newPara, _ := doc.AddParagraph()
+    newRun, _ := newPara.AddRun()
+    newRun.SetText("This paragraph was added by the reader")
+    
+    // Save modified document
+    if err := doc.SaveAs("modified.docx"); err != nil {
+        log.Fatal(err)
+    }
+}
+```
+
 ### More Examples
 
-See the [`examples/`](examples/) directory for comprehensive examples:
+See the [`examples/`](examples/) directory for comprehensive examples (11 working examples):
 
 - **[01_basic](examples/01_basic/)** - Simple document with builder pattern
 - **[02_intermediate](examples/02_intermediate/)** - Professional product catalog
-- **[04_fields](examples/04_fields/)** - TOC, page numbers, hyperlinks (⚠️ needs v2 API update)
+- **[04_fields](examples/04_fields/)** - TOC, page numbers, hyperlinks
 - **[08_images](examples/08_images/)** - Image insertion and positioning
 - **[09_advanced_tables](examples/09_advanced_tables/)** - Cell merging, nested tables, styling
+- **[12_read_and_modify](examples/12_read_and_modify/)** - 🆕 Read and modify existing documents
 
 ---
 
@@ -239,11 +303,12 @@ github.com/mmonterroca/docxgo/
 
 ### 🚧 In Development
 
-**Phase 10: Document Reading** (Not Started)
-- Open and read existing .docx files
-- Parse document structure
-- Modify existing documents
-- Roundtrip testing (create → save → open → verify)
+**Phase 10: Document Reading** (60% Complete - Core Features Working ✅)
+- ✅ Open and read existing .docx files
+- ✅ Parse document structure (paragraphs, runs, tables)
+- ✅ Modify existing documents (edit text, formatting, add content)
+- ✅ Style preservation (Title, Subtitle, Headings, Quote, Normal)
+- 🚧 Advanced features (headers/footers, complex tables, images in existing docs)
 
 **Phase 12: Beta Testing & Release** (In Progress)
 - Community feedback integration
@@ -286,15 +351,15 @@ if err != nil {
 }
 
 // Builder pattern accumulates errors
-doc := docx.NewDocument()
-doc.AddParagraph().
+builder := docx.NewDocumentBuilder()
+builder.AddParagraph().
     Text("Hello").
     FontSize(9999). // Invalid - error recorded
     Bold().
     End()
 
 // All errors surface at Build()
-finalDoc, err := doc.Build()
+doc, err := builder.Build()
 if err != nil {
     // Returns first accumulated error with full context
     log.Fatal(err)