Bir PR Birleştirmeden Önce İki Kez Nasıl Reddedildim
Awesome Second Brain'a katkıda bulunmaya çalıştım. Awesome Second Brain, yapay zeka hafızası ve bilgi sistemleri için açık kaynaklı bir kaynaktır. 200'den fazla yıldızı ve çok katı kuralları var. Karmaşık bir yığın (stack) sundum: Hermes Agent, Obsidian ve Honcho.
İki kez başarısız oldum. Pull request'imin (PR) birleştirilmesi üç düzeltme turu sürdü. İşte yaptığım hatalar ve öğrendiklerim.
1. Dokümantasyon yerine hafızama güvendim Var olduğunu sandığım komutları kullanarak bir kurulum kılavuzu yazdım. Bir yapılandırma (config) dosyasının belirli bir klasörde olduğunu varsaydım. Bir CLI betiğinin mevcut olduğunu varsaydım. Yanılmışım. İkisi de mevcut değildi.
Ders: Bir komutu asla hafızanızdan yazmayın. Resmi dokümanları açın. Tam sayfayı bulun. Tam komutu kopyalayın. Eğer bulamıyorsanız, dahil etmeyin.
2. Hatalı meta veriler kullandım Şirket isimlerini karıştırdım. Obsidian'ı Plastic Labs'in yaptığını sandım. Yapmıyorlar. Tüm yığının açık kaynaklı olduğunu iddia ettim. Değil. Obsidian ve AgentMail tescilli (proprietary) yazılımlardır.
Ders: Her ayrıntıyı doğrulayın. Sorumluyu (maintainer), lisansı ve depo (repo) durumunu kontrol edin. Tahmin yürütmeyin.
3. Kanıt sunmadan genel iddialarda bulundum Yığının "tamamen yerel" (all local) olduğunu iddia ettim. Bu yanlıştı çünkü AgentMail barındırılan (hosted) bir hizmettir. "Ücretsiz" olduğunu iddia ettim. Bu da yanlıştı çünkü barındırılan hizmetlerin maliyetleri vardır.
Ders: İfadelerinizi sınırlandırın. Eğer bir iddia yığının her parçası için geçerli değilse, bunu belirtin. "bileşene göre değişir" gibi ifadeler kullanın. Dürüstlük, genel konuşmaktan daha iyidir.
4. Önce kılavuzları okumadım Katkı sağlama kurallarını ilk reddedilişimden sonra okudum. Başlamadan önce okumalıydım.
Ders: Kuralları iki kez okuyun. Kurallar, hem sizin hem de sorumlunun vaktini korumak için vardır.
Son Düşünceler Reddedilmek can yakar. Ancak geri bildirim adil ve uygulanabilirdi. Final versiyonu daha iyi çünkü doğru ve tutarlı. Çok fazla şey yapmaya çalışmadan önce küçük ve doğru katkılara odaklanın.
İsteğe bağlı öğrenme topluluğu: https://t.me/GyaanSetuAi