# Documentation Archive

**Last Updated:** 2026-04-01

Archive directory for completed projects, deprecated scripts, and historical documentation.

## Archive Cleanup (2026-01-15)

Historical archived files (completion summaries, old testing results, implementation reports) have been deleted to reduce clutter. All deleted files are preserved in Git history and can be accessed using Git commands.

## Current Archive Structure

```
docs/archive/
├── 2026-04-01-docs-cleanup/     # Index: README.md — stale root reports, link-validation snapshot, UTM analyses
├── blog-migration/
│   ├── scripts/
│   │   └── README.md           # Script deprecation notice (scripts deleted)
│   └── README.md               # Blog migration archive overview
├── blog-status-files/          # README.md — frozen blog sprint statuses (2026-01)
└── completed-projects/         # Empty directory (for future use)
```

## Deleted Archive Contents

The following archive contents were deleted on 2026-01-15:

### 2025 Testing Results (~22MB)
- `docs/archive/2025/testing-results/` - Old validation/testing results
- Old testing summaries, validation reports, and JSON backup files

### Completed Projects (~420KB)
- `docs/archive/completed-projects/blog-status/` - 33 blog status/completion files
- `docs/archive/completed-projects/restructuring/` - 7 restructuring completion files
- Individual completion summaries and implementation reports

### Blog Migration Scripts (~10KB)
- `extract-wordpress-meta.php` - WordPress metadata extraction
- `extract-content.py` - WordPress content extraction
- `convert-wordpress-urls-in-json.py` - WordPress URL conversion

**Rationale:** These files were redundant completion summaries, obsolete testing results, and deprecated scripts. All information is preserved in Git history.

## Accessing Deleted Files

All deleted files are preserved in Git history. To access:

```bash
# Find when a file was deleted
git log --all --full-history -- docs/archive/completed-projects/blog-status/ALL_PENDING_TASKS_COMPLETE.md

# View a deleted file
git show <commit-hash>:docs/archive/completed-projects/blog-status/ALL_PENDING_TASKS_COMPLETE.md

# List all deleted archive files
git log --all --diff-filter=D --summary -- docs/archive/

# View deleted 2025 testing results
git log --all --full-history -- docs/archive/2025/testing-results/
```

## Archive Policy

### What Gets Archived (Going Forward)

1. **Completed Projects** (if truly needed)
   - Only archive if information is not duplicated in active status files
   - Prefer deletion with Git history preservation

2. **Deprecated Scripts**
   - Keep README documenting deprecation
   - Delete scripts (preserved in Git history)

3. **Historical Documentation**
   - Delete old testing results (preserved in Git history)
   - Delete redundant completion summaries (preserved in Git history)

### Archive Guidelines

1. **Prefer Deletion Over Archiving**
   - Most historical files should be deleted
   - All files preserved in Git history
   - Reduces repository clutter

2. **Update References**
   - Update references to note Git history location
   - Document deletion in relevant files

3. **Document Purpose**
   - Add README files explaining what was deleted and why
   - Provide Git commands for accessing deleted files

## Current Archive Contents

### Blog Migration (`blog-migration/`)

- **README.md**: Blog migration archive overview
- **scripts/README.md**: Script deprecation notice (scripts deleted, available in Git history)

### Completed Projects (`completed-projects/`)

- Empty directory reserved for future use (if truly needed)

## Maintenance

### Regular Cleanup

- **Monthly:** Review for files that can be deleted
- **Quarterly:** Check for redundant completion summaries
- **Annually:** Delete old testing results and backups (preserved in Git history)

### Deletion Guidelines

1. **Delete Before Archiving:** Prefer deletion with Git history preservation
2. **Update References:** Update all references before deletion
3. **Document Deletion:** Note deletions in relevant documentation
4. **Preserve Git History:** All files preserved in Git - can be retrieved

## Related Documentation

- [Documentation Maintenance Process](../DOCUMENTATION_MAINTENANCE_PROCESS.md) - Updated archive process guidelines
- [Archive Deletion Analysis](../ARCHIVE_DELETION_ANALYSIS.md) - Original analysis recommending deletion
- [Documentation Cleanup Complete 2026](../DOCUMENTATION_CLEANUP_COMPLETE_2026.md) - Previous cleanup work
- [Restructuring Complete](../RESTRUCTURING_COMPLETE.md) - Restructuring summary

---

**Archive Created:** 2026-01-10  
**Archive Cleanup:** 2026-01-15  
**Status:** ✅ Minimal archive - Historical files available in Git history