2.2 KiB
2.2 KiB
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 categoriesdocs/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 stepsdocs/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.mdtoPROGRESS_REPORTS/archive/ - Keep review summaries as reference (move to
docs/reference/if needed)
4. Status Files - KEEP
Files:
PROGRESS_REPORTS/PROJECT_STATUS.md- Current statusdocs/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- TemplatesPROGRESS_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