Apollo-11/CONTRIBUTING.tr.md
2020-10-19 19:19:30 +01:00

5.7 KiB
Raw Blame History

Katkıda Bulunma

🎌 Čeština, Deutsch, English, Español, Français, Italiano, Kurdi, Lietuvių, Nederlands, Norsk, Polski, Português, Türkçe, Ελληνικά, العربية, 日本語, 正體中文, 简体中文, 한국어

Bu repodaki kaynak kodu kağıt çıktılarından elle dijitalleştirilmiştir. Yani yazım hataları ve diğer tutarsızlıklar yanlışlıkla yapılmıştır. Kod, aşağıdaki taratılmış çıktılar ile tutarlı olması için düzenlenmelidir:

Yararlı Eklentiler

Github, AGC assembly dili için sentaks desteği sağlıyor ama sizin kodu düzenlemek için kullandığınız editör sağlamayacaktır. Aşağıdaki editörler AGC dili sentaks vurgulaması için eklentiler sunmaktadır:

† Otomatik biçimlendirmeyi destekler

Biçimlendirme

Not: GitHub ve yukarıdaki 3 eklenti otomatik olarak doğru biçimlendirmeyi kullanmanızı sağlayacaktır.

  • Girintilemeyi tab ile yapın
  • Tab genişliği olarak 8'i kullanın
  • Devamındaki boşlukları silin

Neyi kontrol edeyim?

Taratılmış çıktılar ve bu repodaki kaynak kodu arasındaki herhangi bir tutarsızlığı.

Yorumlar

Uyarlanan koddaki yorum satırları, çıktılar ile tamamen eşleşmelidir.

Düzeltmek için bakmanız gereken bazı temel sorunlar şunlardır:

Yazım Hataları

Bazı yerlerde, orijinal geliştiriciler yorum yazarken yazım hataları yapmış. Bunların bazıları dijitalleştirme sürecinin başlarında yanlışlıkla düzeltildi fakat dijitalleştirme süreci taratılmış çıktılarda olmayan yeni yazım hatalarına da sebep oldu.

Örneğin, dijitalleştirilmiş yorumlar SPACECRAFT kelimesini içeriyorsa ama taratılmış çıktılarda SPAECRAFT yazıyorsa, dijitalleştirilmiş yorum SPAECRAFT (C eksik) olarak düzeltilmelidir.

Aynı şekilde, eğer dijitalleştirmiş yorumlarda bir yazım hatası varsa ama taratılmış çıktılarda doğru yazılmışsa, yazım hatası düzeltilmelidir.

Boşluklar

Yorumlar arasındaki iki karakterin arasındaki boşluklar taratılmış çıktılar ile uyuşmalıdır. Bir çok durumda (#316'daki tartışmayı inceleyin) boşluklar şu şekildedir:

  • Yeni kelimeler arası tek boşluk.
  • Yeni cümleler arası iki boşluk.
  • Yeni girintiler için üç boşluk.

Taratılmış çıktılarda bütün sayfalar bu genellemelere uymaz. Eğer çıktılarda iki boşluk yerine bir boşluk varsa, bir boşluk kullanın.

Satır sonları

  • Birinci sütunu R0000 ile biten satır sonları çıktılar ile tamamen eşleşmelidir.
  • Birinci sütunu R0000 olmadan biten satır sonları arka arkaya sadece 1 ya da 2 boş satır içermelidir.
    • Eğer 2'den fazla satır sonu varsa ekstra olan satır sonlarını kaldırın.
      • Birinci sütunu R0000 ile biten satırlar bu kural dahilinde değildir.
    • Kaynak resimlerde bunlar 8. satırındaki basamak bastırılmamış halde oluşturulmuştur. Bir 2 kullanımı iki boşluğu (tek boş satırı) temsil ederken, bir 3 kullanımı üç boşluğu (iki boş satırı) ifade eder. 4 ve 8 tanımlanmıştır fakat hiç kullanılmamıştır. Bunun hakkında daha fazla okumak için: #159

Örneğin bu:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Buna dönüşmeli:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Not

PR yapmadan önce lütfen yaptığınız değişikliklerin çıktılar ile tutarlı olduğundan emin olun!