NETRA Documentation Files - Comparison Report
Generated: April 17, 2026
π File Location Summary
Files IN docs/ folder:
ANOMALY_DETECTION_GUIDE.mdARCHITECTURE.mdMIGRATION_GUIDE.mdPROJECT_STRUCTURE.mdQUICK_REFERENCE.md
Files IN root/ folder:
ANOMALY_DETECTION_GUIDE.mdβ οΈ DUPLICATECLEANUP_ANALYSIS.mdβ¨ NEW (added by me)CONSOLIDATION_COMPLETE.mdβ¨ NEW (added by me)MODEL_CONSOLIDATION_GUIDE.mdβ¨ NEW (added by me)README.mdβ Main project doc (not in docs/)
π Detailed Comparison
DUPLICATES FOUND:
| File | Location 1 | Location 2 | Status | Size | Hash |
|---|---|---|---|---|---|
ANOMALY_DETECTION_GUIDE.md |
root/ |
docs/ |
β οΈ IDENTICAL | Both same | BED79FB8... |
Action: One should be removed (recommend keeping in root/ for quick access, move to docs/ if organized structure preferred)
Files ONLY in docs/:
| File | Purpose | Should Keep? |
|---|---|---|
ARCHITECTURE.md |
System architecture documentation | β Yes - Keep in docs/ |
MIGRATION_GUIDE.md |
Migration guide from old NETRA to new src | β Yes - Keep in docs/ |
PROJECT_STRUCTURE.md |
Project structure explanation | β Yes - Keep in docs/ |
QUICK_REFERENCE.md |
Quick reference guide | β Yes - Keep in docs/ |
Note: These are organizational documentation - should stay in docs/
Files ONLY in root/ (Project Root):
| File | Purpose | Should Keep? | Category |
|---|---|---|---|
README.md |
Main project documentation | β Yes | Core |
CLEANUP_ANALYSIS.md |
Cleanup analysis report | β Yes | Maintenance |
CONSOLIDATION_COMPLETE.md |
Consolidation summary | β Yes | Maintenance |
MODEL_CONSOLIDATION_GUIDE.md |
Model consolidation guide | β Yes | Maintenance |
Note: These are project-level guides and should stay in root/ for visibility
π Current Structure Analysis
Root Level Documentation
Root/
βββ README.md (Main project doc)
βββ ANOMALY_DETECTION_GUIDE.md (β οΈ DUPLICATE - also in docs/)
βββ CLEANUP_ANALYSIS.md (Cleanup report)
βββ CONSOLIDATION_COMPLETE.md (Consolidation summary)
βββ MODEL_CONSOLIDATION_GUIDE.md (Model consolidation guide)
Docs Folder Documentation
docs/
βββ ANOMALY_DETECTION_GUIDE.md (β οΈ DUPLICATE - also in root/)
βββ ARCHITECTURE.md (System architecture)
βββ MIGRATION_GUIDE.md (Migration guide)
βββ PROJECT_STRUCTURE.md (Project structure)
βββ QUICK_REFERENCE.md (Quick reference)
β Recommendations
Option 1: Keep Organized Structure (RECOMMENDED)
Action:
1. DELETE: root/ANOMALY_DETECTION_GUIDE.md
2. MOVE: root/CLEANUP_ANALYSIS.md β docs/CLEANUP_ANALYSIS.md
3. MOVE: root/CONSOLIDATION_COMPLETE.md β docs/CONSOLIDATION_COMPLETE.md
4. MOVE: root/MODEL_CONSOLIDATION_GUIDE.md β docs/MODEL_CONSOLIDATION_GUIDE.md
5. KEEP: root/README.md (main entry point)
Result:
- Root: Only README.md + requirements.txt + code folders
- docs/: All documentation organized
- Clean & professional structure
Option 2: Keep Current State (NO ACTION)
No changes - works fine as is
- Cleanup guides visible at root level for quick reference
- Slightly redundant (ANOMALY_DETECTION_GUIDE.md duplicate)
- Less organized
Option 3: Hybrid Approach
Action:
1. DELETE: root/ANOMALY_DETECTION_GUIDE.md (remove duplicate)
2. KEEP: root/README.md
3. KEEP: root/CLEANUP_ANALYSIS.md (important maintenance docs)
4. KEEP: root/CONSOLIDATION_COMPLETE.md
5. KEEP: root/MODEL_CONSOLIDATION_GUIDE.md
6. Keep docs/ as is for reference documentation
Result: Maintenance docs at root, reference docs in docs/
π― Summary Table
| Aspect | Status | Details |
|---|---|---|
| Duplicates Found | β οΈ 1 | ANOMALY_DETECTION_GUIDE.md (identical in both locations) |
| New Docs Added | β¨ 3 | Cleanup/consolidation guides created during session |
| Docs-Only Files | β 4 | ARCHITECTURE, MIGRATION, PROJECT_STRUCTURE, QUICK_REFERENCE |
| Root-Only Files | β 5 | README + cleanup guides |
| Organization Level | π‘ Medium | Could be improved with consolidation |
| Redundancy | π‘ Low | Only 1 duplicate found |
π‘ Quick Decision Guide
If you want clean organization: β Choose Option 1 (move everything to docs/)
If you want quick access to cleanup guides: β Choose Option 3 (keep maintenance docs at root)
If you prefer current state: β Choose Option 2 (no action)
Recommendation: Option 1 provides professional project structure with docs/ containing all documentation and README at root as the entry point.