Açık Kaynak Katkıcıları için Ekran Kaydı

Açık kaynak projelerine katkı sağlamak hiç bu kadar görsel olmamıştı. Ekran kayıtları, maintainer’ların değişikliklerinizi daha hızlı anlamasına yardımcı olur, hata raporlarını tartışmasız hale getirir ve pull request’lerinize hak ettikleri bağlamı kazandırır. İster ilk kez katkıda bulunan biri olun, ister deneyimli bir maintainer, Recorded’ı kullanarak açık kaynak iş akışınızı nasıl üst seviyeye taşıyacağınızı keşfedelim.

Açık Kaynakta Ekran Kayıtları Neden Önemlidir?

Metin açıklamaları yalnızca belirli bir noktaya kadar işe yarar. 30 saniyelik bir ekran kaydı, ne gördüğünüz, ne denediğiniz ve düzeltmenizin gerçekte ne yaptığı konusundaki tüm belirsizliği ortadan kaldırarak sayfalar dolusu açıklamanın yerini alabilir.

Açık kaynak maintainer’ları her hafta onlarca sorun ve PR inceler. Net bir video demosu, sizinkinin öne çıkmasını ve daha hızlı birleştirilmesini sağlar.

Düzeltilen Hata Raporları Kaydetmek

Bir raporlayıcı olarak yapabileceğiniz en etkili şey, hatanın gerçekleştiğini göstermektir. Video hata raporu:

• Belirsizliği ortadan kaldırır: Maintainer’lar tam olarak sizin gördüğünüzü görür
• Triyajı hızlandırır: Yeniden üretim adımları için ileri geri gidip gelmek gerekmez
• Tekrarlanabilirliği kanıtlar: Hatanın rastlantısal olmadığını gösterir

Harika Bir Hata Raporu Nasıl Kaydedilir?

1. Tam bağlamı yakalayın: Maintainer’ların kurulumu görebilmesi için hatayı tetiklemeden önce kaydı başlatın
2. Zoom efektlerini kullanın: Recorded’ın zoom özelliğiyle bozuk UI öğesini veya hata mesajını vurgulayın
3. Konsolu dahil edin: Tarayıcı geliştirici araçlarını veya terminal çıktısını UI’ın yanında gösterin
4. Kısa tutun: 30-90 saniye idealdir; editörle boş zamanları kesin

Pull Request’leri Video ile Göstermek

Önce/sonra ekran kaydı içeren bir PR açıklaması, inceleme güvenini büyük ölçüde artırır. Maintainer’lar, branch’i yerel olarak çekmeden değişikliğinizin işe yaradığını görebilir.

PR Demosunda Ne Gösterilmeli?

• Sorun: Orijinal bozuk davranışı kısaca gösterin (10-15 saniye)
• Düzeltmeniz: Düzeltilmiş davranışı net bir şekilde ortaya koyun
• Kenar durumlar: Bitişik özelliklerin hâlâ doğru çalıştığını gösterin
• Kod özeti (isteğe bağlı): Editörünüzdeki önemli değişiklikleri tarayın

Her bölümü ayrı ayrı kaydedin ve Recorded’ın kırpma aracını kullanarak aralarında temiz geçişler yapın.

Proje Belgeleri ve Tur Videoları Oluşturmak

Bir açık kaynak projesi yönetiyorsanız video belgeler büyük kazanımlar sağlar. Yeni katkıcılar daha hızlı adapte olur ve aynı sorular issue’larda tekrar etmeyi bırakır.

Yüksek Değerli Belgeleme Videoları

• Başlarken: Clone’dan çalışan uygulamaya kadar 2-3 dakikalık kurulum turu
• Mimari genel bakış: Kod tabanı dizin yapısını anlatımla birlikte gezin
• Katkı rehberi: Testleri nasıl çalıştıracağınızı, kodu biçimlendireceğinizi ve PR açacağınızı gösterin
• Özellik demoları: README’nizdeki her önemli özellik için kısa kayıtlar

Bunları projenizin GitHub Releases bölümüne, wiki’ye veya README’den bağlantı verilen özel bir YouTube kanalına yükleyin.

Kod İncelemelerini Kaydetmek

Video ile asenkron kod incelemeleri, dağıtık ekipler arasında giderek daha popüler hale geliyor. Uzun satır içi yorumlar yazmak yerine diff’i gezerken ekranınızı kaydedin.

Video kod incelemelerinin faydaları:

• Ton daha nettir (metin sert okunabilir)
• Konuşurken belirli satırlara işaret edebilirsiniz
• İnceleyiciler daha az zamanda daha fazla alanı kapsar

İzleyicilerin nereye işaret ettiğinizi takip edebilmesi için Recorded’ın imleç vurgulama özelliğini kullanın.

Açık Kaynak Ekran Kayıtları için Pratik İpuçları

Videoları kısa tutun: Açık kaynak maintainer’ları sınırlı zamanı olan gönüllülerdir. Hata raporları için 2 dakikanın, PR demoları için 3 dakikanın altında kalmayı hedefleyin.

Temiz bir ortam kullanın: İlgisiz sekmeleri ve uygulamaları kapatın. Kayıt için ayrı bir tarayıcı profili kullanın.

Metin katmanları ekleyin: Bölümleri “Önce” ve “Sonra” veya “Hata” ve “Düzeltildi” olarak etiketlemek için Recorded’ın metin katmanı özelliğini kullanın.

Basit hatalar için GIF olarak dışa aktarın: Kısa, döngüsel UI hataları için doğrudan issue’ya gömülü bir GIF, videodan bile daha hızlı tüketilir.

Akıllıca barındırın: GitHub issue’ları ve PR’lar doğrudan video yüklemeyi destekler. Daha uzun belgeleme videoları için YouTube gizli bağlantıları iyi çalışır.

Başlarken

Recorded’ı açın, yalnızca tarayıcınızı veya kod editörünüzü kaydetmek için Pencere yakalama modunu seçin, anlatım için mikrofonunuzu etkinleştirin ve kaydı başlatın. Kayıt sonrasında boş zamanları kırpın, önemli anı vurgulamak için zoom efekti ekleyin ve dışa aktarın.

Bir sonraki hata raporunuz veya PR’ınız kendini anlatacak.