Belgelendirme neden önemlidir
- Güncel API’ler ve parametreler
- En iyi uygulamalar
- Organizasyon gelenekleri
- Alan terminolojisi
Model bilgi kesim tarihi
- En son kütüphane güncellemeleri yansımamış olabilir
- Yeni çatı (framework) veya araçlar bilinmeyebilir
- Kesim tarihinden sonra yapılan API değişiklikleri atlanır
- En iyi uygulamalar eğitimden bu yana değişmiş olabilir
Hangi aracı kullanmalıyım?
Zihinsel model
Araç | Zihinsel model |
---|---|
@Docs | Resmi dokümantasyonda gezinip okumak gibi |
@Web | İnternette çözüm aramak gibi |
MCP | Kendi dahili dokümantasyonuna erişmek gibi |
Public documentation
@Docs’u kullanma
@Docs
, Cursor’ı popüler araç ve framework’lerin resmi dokümantasyonuna bağlar. Şu konularda güncel ve yetkili bilgiye ihtiyaç duyduğunda kullan:
- API referansları: Fonksiyon imzaları, parametreler, dönüş tipleri
- Başlangıç rehberleri: Kurulum, yapılandırma, temel kullanım
- En iyi uygulamalar: Kaynaktan önerilen kalıplar
- Framework’e özel hata ayıklama: Resmi sorun giderme rehberleri
@
@Docs Next.js Catch-all rotalarla dinamik yönlendirmeyi nasıl kurarım?
∞
Agent⌘I
Auto
@Web’i kullanma
@Web
, güncel bilgiler, blog yazıları ve topluluk tartışmaları için canlı internette arama yapar. Şunlara ihtiyacın olduğunda kullan:
- Güncel eğitimler: Topluluk kaynaklı içerikler ve örnekler
- Karşılaştırmalar: Farklı yaklaşımları karşılaştıran yazılar
- En son güncellemeler: Çok yeni güncellemeler veya duyurular
- Birden fazla bakış açısı: Sorunlara farklı yaklaşımlar
@
@Web React 19 için en yeni performans optimizasyonları
∞
Agent⌘I
Auto
İç dokümantasyon
- Dahili API’ler: Özel servisler ve mikroservisler
- Şirket standartları: Kodlama kuralları, mimari desenler
- Mülkiyet sistemler: Özel araçlar, veritabanları, iş akışları
- Alan bilgisi: İş mantığı, uyumluluk gereksinimleri
MCP ile dahili dökümanlara erişim
- Modeller dahili uygulamalarını/alışkanlıklarını tahmin edemez
- Özel servisler için API dökümantasyonu herkese açık değildir
- İş mantığı ve alan bilgisi organizasyonuna özeldir
- Uyum ve güvenlik gereksinimleri şirkete göre değişir
Yaygın MCP entegrasyonları
Entegrasyon | Erişim | Örnekler |
---|---|---|
Confluence | Şirket Confluence alanları | Mimari dökümantasyon, dahili servisler için API spesifikasyonları, kod standartları ve yönergeler, süreç dökümantasyonu |
Google Drive | Paylaşılan belgeler ve klasörler | Spesifikasyon dokümanları, toplantı notları ve karar kayıtları, tasarım dokümanları ve gereksinimler, ekip bilgi tabanları |
Notion | Çalışma alanı veritabanları ve sayfalar | Proje dökümantasyonu, ekip vikileri, bilgi tabanları, ürün gereksinimleri, teknik spesifikasyonlar |
Custom | Dahili sistemler ve veritabanları | Tescilli API’ler, legacy dökümantasyon sistemleri, özel bilgi tabanları, uzmanlaşmış araçlar ve iş akışları |
Özel çözümler
- Dahili web sitelerini veya portalları taramak
- Tescilli veritabanlarına bağlanmak
- Özel dökümantasyon sistemlerine erişmek
- Dahili vikilerden veya bilgi tabanlarından veri çekmek
Özel bir MCP sunucusu geliştirirsen, Cursor’ın dökümantasyonu güncellemesi için araçlar da expose edebilirsin
Dokümanları güncel tutmak
Mevcut koddan
@
Bu Express router için, tüm uç noktalar, parametreler ve yanıt formatları dahil olmak üzere API dokümantasyonu oluştur
∞
Agent⌘I
Auto
Sohbet oturumlarından
Karmaşık bir sorun çözüldükten sonra:
@
Kimlik doğrulamayı kurma üzerine sohbetimizi ekip wikisi için adım adım bir rehbere özetle
∞
Agent⌘I
Auto
Özet
- Belgeleri bağlam olarak kullanmak, Cursor’ı daha isabetli ve güncel yapar
- Resmi dokümantasyon için
@Docs
, topluluk bilgisi için@Web
kullan - MCP, Cursor ile dahili sistemlerin arasındaki boşluğu kapatır
- Bilgiyi güncel tutmak için koddan ve sohbetlerden dokümantasyon üret
- Kapsamlı bir anlayış için harici ve dahili dokümantasyon kaynaklarını birleştir