_research-notes.md

 1<!--
 2  TEMPORARY RESEARCH FILE - Delete when migration guides are complete
 3
 4  This file contains external community insights used to add "flair" to migration guides.
 5  These are NOT the template or backbone—use intellij.md as the structural template.
 6
 7  STATUS:
 8  ✅ PyCharm guide - COMPLETE
 9  ✅ WebStorm guide - COMPLETE
10  ✅ RustRover guide - COMPLETE
11-->
12
13# Migration Research Notes
14
15## Completed Guides
16
17All three JetBrains migration guides have been populated with full content:
18
191. **pycharm.md** - Python development, virtual environments, Ruff/Pyright, Django/Flask workflows
202. **webstorm.md** - JavaScript/TypeScript development, npm workflows, framework considerations
213. **rustrover.md** - Rust development, rust-analyzer parity, Cargo workflows, licensing notes
22
23## Key Sources Used
24
25- IntelliJ IDEA migration doc (structural template)
26- JetBrains PyCharm Getting Started docs
27- JetBrains WebStorm Getting Started docs
28- JetBrains RustRover Quick Start Guide
29- External community feedback (Reddit, Hacker News, Medium)
30
31## External Quotes Incorporated
32
33### WebStorm Guide
34
35> "I work for AWS and the applications I deal with are massive. Often I need to keep many projects open due to tight dependencies. I'm talking about complex microservices and micro frontend infrastructure which oftentimes lead to 2-15 minutes of indexing wait time whenever I open a project or build the system locally."
36
37### RustRover Guide
38
39- Noted rust-analyzer shared foundation between RustRover and Zed
40- Addressed licensing/telemetry concerns that motivate some users to switch
41- Included debugger caveats based on community feedback
42
43## Cross-Cutting Themes Applied to All Guides
44
45### Universal Pain Points Addressed
46
471. Indexing (instant in Zed)
482. Resource usage (Zed is lightweight)
493. Startup time (Zed is near-instant)
504. UI clutter (Zed is minimal by design)
51
52### Universal Missing Features Documented
53
54- No project model / SDK management
55- No database tools
56- No framework-specific integration
57- No visual run configurations (use tasks)
58- No built-in HTTP client
59
60### JetBrains Keymap Emphasized
61
62All three guides emphasize:
63
64- Select JetBrains keymap during onboarding or in settings
65- `Shift Shift` for Search Everywhere works
66- Most familiar shortcuts preserved
67
68## Next Steps (Optional Enhancements)
69
70- [ ] Cross-link guides to JetBrains docs for users who want to reference original IDE features
71- [ ] Add a consolidated "hub page" linking to all migration guides
72- [ ] Consider adding VS Code migration guide using similar structure
73- [ ] Review for tone consistency against Zed Documentation Guidelines