# SIDE-BY-SIDE MARKDOWN FILE COMPARISON TEMPLATE

## DOCUMENT OVERVIEW

- File A Name:
- File B Name:
- Comparison Date:
- Reviewer:
- Target Renderer / Platform:
- Comparison Purpose:
- Canonical File Expected:
- Source of Truth Confirmed:
- Overall Recommendation:

---

## EXECUTIVE SUMMARY

### File A Summary
- Primary purpose:
- Strengths:
- Weaknesses:
- Risks:
- Publication readiness:

### File B Summary
- Primary purpose:
- Strengths:
- Weaknesses:
- Risks:
- Publication readiness:

### Bottom-Line Judgment
- Preferred file:
- Why:
- Whether merge/reconciliation is needed:
- Whether either file contains blockers:

---

## SIDE-BY-SIDE CATEGORY TABLE

| Category | File A | File B | Key Differences | Impact Level | Preferred |
|---|---|---|---|---|---|
| File Identity and Scope |  |  |  |  |  |
| Document Purpose and Intent |  |  |  |  |  |
| Front Matter and Metadata |  |  |  |  |  |
| Title and Heading Hierarchy |  |  |  |  |  |
| Section Presence and Coverage |  |  |  |  |  |
| Content Fidelity and Meaning Preservation |  |  |  |  |  |
| Accuracy and Factual Consistency |  |  |  |  |  |
| Completeness of Technical Detail |  |  |  |  |  |
| Structural Coherence and Flow |  |  |  |  |  |
| Paragraph and Sentence Quality |  |  |  |  |  |
| Terminology and Lexical Consistency |  |  |  |  |  |
| Voice, Tone, and Register |  |  |  |  |  |
| Style Guide Compliance |  |  |  |  |  |
| Markdown Syntax Correctness |  |  |  |  |  |
| Renderer Compatibility |  |  |  |  |  |
| Lists, Tables, Links, and Media |  |  |  |  |  |
| Code Blocks and Inline Code |  |  |  |  |  |
| Accessibility |  |  |  |  |  |
| Security and Privacy Review |  |  |  |  |  |
| Maintainability and Publication Readiness |  |  |  |  |  |

---

## DETAILED DIFFERENCE LOG

### 1. File Identity and Scope
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 2. Document Purpose and Intent
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 3. Front Matter and Metadata
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 4. Title and Heading Hierarchy
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 5. Section Presence and Coverage
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 6. Content Fidelity and Meaning Preservation
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 7. Accuracy and Factual Consistency
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 8. Completeness of Technical Detail
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 9. Structural Coherence and Flow
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 10. Paragraph and Sentence Quality
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 11. Terminology and Lexical Consistency
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 12. Voice, Tone, and Register
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 13. Style Guide Compliance
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 14. Markdown Syntax Correctness
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 15. Renderer Compatibility
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 16. Lists, Tables, Links, and Media
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 17. Code Blocks and Inline Code
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 18. Accessibility
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 19. Security and Privacy Review
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

### 20. Maintainability and Publication Readiness
**File A:**
- 

**File B:**
- 

**Differences:**
- 

**Impact:**
- 

**Verdict:**
- 

---

## CRITICAL FINDINGS

### Blocking Issues
- 
- 
- 

### High-Impact Differences
- 
- 
- 

### Medium-Impact Differences
- 
- 
- 

### Low-Impact Differences
- 
- 
- 

---

## MISSING CONTENT REVIEW

### Missing from File A
- 
- 
- 

### Missing from File B
- 
- 
- 

---

## SYNTAX / RENDERING REVIEW

### File A Syntax Issues
- 
- 
- 

### File B Syntax Issues
- 
- 
- 

### Renderer Compatibility Risks
- 
- 
- 

---

## FINAL DECISION

- Preferred file:
- Why it wins:
- Whether merge is recommended:
- Whether subject-matter review is needed:
- Whether publication is approved:
- Reviewer confidence:

**DAS ENDE**