69 lines
2.2 KiB
Markdown
69 lines
2.2 KiB
Markdown
# Deduplication and Pruning Plan v2
|
|
|
|
## Analysis Complete - 2024-11-21
|
|
|
|
## Findings
|
|
|
|
### 1. Documentation Indexes - CONSOLIDATE
|
|
**Files:**
|
|
- `docs/README.md` (253 lines) - Comprehensive index with all categories
|
|
- `docs/README.md` (253 lines) - Nearly identical content
|
|
|
|
**Action:** Merge `docs/README.md` into `docs/README.md` and remove `docs/README.md`
|
|
**Reason:** Complete duplication - same structure and content
|
|
|
|
### 2. Getting Started Guides - KEEP SEPARATE
|
|
**Files:**
|
|
- `docs/setup/GETTING_STARTED.md` - General getting started (prerequisites, setup)
|
|
- `docs/setup/NEXT_STEPS_AFTER_BUILD.md` - Specific post-build steps
|
|
- `docs/setup/PARALLEL_TASKS_WHILE_BUILDING.md` - Tasks during build
|
|
|
|
**Action:** Keep all three - they serve different purposes
|
|
**Reason:** Different audiences and use cases
|
|
|
|
### 3. Summary Files - ARCHIVE OR MERGE
|
|
**Files:**
|
|
- `IMPROVEMENTS_SUMMARY.md` - Recent improvements (can archive after review)
|
|
- `docs/reference/WORKFLOW_REVIEW_SUMMARY.md` - Workflow review (reference material)
|
|
- `docs/reference/ASSET_REVIEW_SUMMARY.md` - Asset review (reference material)
|
|
|
|
**Action:**
|
|
- Archive `IMPROVEMENTS_SUMMARY.md` to `PROGRESS_REPORTS/archive/`
|
|
- Keep review summaries as reference (move to `docs/reference/` if needed)
|
|
|
|
### 4. Status Files - KEEP
|
|
**Files:**
|
|
- `PROGRESS_REPORTS/PROJECT_STATUS.md` - Current status
|
|
- `docs/PROJECT_HEALTH.md` - Health dashboard
|
|
|
|
**Action:** Keep both - different purposes
|
|
**Reason:** Status is operational, Health is metrics
|
|
|
|
### 5. Progress Reports - REVIEW
|
|
**Files:**
|
|
- `PROGRESS_REPORTS/week*.md` - Templates
|
|
- `PROGRESS_REPORTS/archive/*.md` - Archived reports
|
|
|
|
**Action:** Keep templates, verify archived reports are truly archived
|
|
|
|
## Execution Plan
|
|
|
|
### Step 1: Remove Duplicate Index
|
|
- [ ] Remove `docs/README.md`
|
|
- [ ] Update any references to `docs/README.md` → `docs/README.md`
|
|
|
|
### Step 2: Archive Summary Files
|
|
- [ ] Move `IMPROVEMENTS_SUMMARY.md` → `PROGRESS_REPORTS/archive/`
|
|
- [ ] Review if review summaries should be moved to `docs/reference/`
|
|
|
|
### Step 3: Verify References
|
|
- [ ] Search for references to removed files
|
|
- [ ] Update all links
|
|
- [ ] Verify no broken links
|
|
|
|
### Step 4: Final Cleanup
|
|
- [ ] Remove any temporary analysis files
|
|
- [ ] Update CHANGELOG.md
|
|
- [ ] Create deduplication report
|
|
|