Yöntem'i birlikte geliştirelim.

Soru sormak ve hata bildirmek

Sorularınızı, önerilerinizi ve karşılaştığınız hataları GitHub'da bir konu (issue) açarak iletebilirsiniz; GitHub hesabınız yoksa info@yontem.pro adresine de yazabilirsiniz. Daha önce açılmış konulara göz atmanız, aynı sorunun yanıtını hemen bulmanızı sağlayabilir.

Bir hata bildirirken şunları eklemeniz, sorunun hızla anlaşılmasına yardımcı olur:

• Hatayı gösteren en kısa program,
• beklediğiniz çıktı ile aldığınız çıktı ya da hata mesajının tamamı,
• yontem --surum ve node --version komutlarının çıktısı ile işletim sisteminiz.

Katkıda bulunmak

Katkı yalnızca derleyici kodu demek değildir. Aşağıdakilerin hepsi değerlidir:

• Belgeler ve kitaplar: yazım hataları, anlaşılmayan paragraflar, eksik örnekler.
• Örnek programlar: bir konuyu iyi anlatan kısa ve çalışan programlar.
• Hata düzeltmeleri ve yeni özellikler: derleyici, yorumlayıcı, birimler ve araçlar.
• Sınama: Yöntem'i farklı işletim sistemlerinde ve kartlarda deneyip sonucu bildirmek.

Yöntem'in iki uygulaması vardır (JavaScript derleyicisi ve Python yorumlayıcısı) ve ikisinin de aynı çıktıyı vermesi beklenir; bir değişiklik gönderirken test takımlarının hepsinin geçmesi gerekir. Geliştirme ortamının kurulumu, kod düzeni ve değişiklik gönderme adımları katkı rehberinde anlatılır.

Katkı rehberi →

Biriminizi paylaşmak

Yazdığınız bir birimi başkalarının kullanmasını istiyorsanız onu herkese açık bir Git deposuna koyup bir sürüm etiketi vermeniz yeterlidir. Merkezî bir paket deposu yoktur; paketler doğrudan kaynağından kurulur.

yontem paket ekle github:kullanici/depo@v1.0.0

Kurulum yalnızca dosya kopyalar; paketteki hiçbir kod kurulum sırasında çalışmaz. Yine de bir paket, programınızla birlikte çalışacak koddur: güvenmediğiniz bir kaynaktan paket kurmamanızı öneririz. Ayrıntıları Birimler ve Araçlar Kılavuzu'nun "Paketler" bölümünde bulabilirsiniz.

Güvenlik açığı bildirmek

Bir güvenlik açığı bulduğunuzu düşünüyorsanız bunu herkese açık bir konu olarak yazmak yerine özel olarak bildirmenizi rica ederiz; böylece düzeltme yayımlanmadan önce açık kötüye kullanılamaz. Bunun için deponun GitHub sayfasındaki Security → Report a vulnerability yolunu kullanabilirsiniz; bildirimin alındığı bir hafta içinde yanıtlanmaya çalışılır.

Güvenlik politikası →

Birbirimize nasıl davranırız

Yöntem'in kullanıcılarının önemli bir bölümü programlamaya yeni başlayanlardır. Sorulara sabırla yanıt vermek, eleştiriyi kişiye değil koda yöneltmek ve herkesin bir zamanlar yeni başlayan olduğunu hatırlamak, bu topluluğun temel kuralıdır.