Programlama dili çalışılırken nasıl not alınır?

627056

Centipat
Katılım
11 Şubat 2023
Mesajlar
1.216
Çözümler
3
Sizce nasıl not edeyim? Ayrı bir yere mi not alayım yoksa programın içine mi yazayım? Çok karışıklık yaratır mı programda not etmek?
 
bu tamamen programı yazan kişinin insiyatifine kalmış bir durum şahsen kendim yazdığım her şeyin açıklamasını karşısında görmek adına karşısına yorum satırı olarak yazarım ayrı bir yere not edince ne nerede karmaşıklığı oluyor
 
Şundan az:
Kod:
function isSocketAvaible() {
   // İletişim soketi bir başka fonksiyon
Tarafından kullanılıyorsa false
Döner eğer müsaitse true
Döner false durumunda
1 saniye bekleyerek
Soketi tekrar sorgulayın

   return sockets[-1].status
}

Bundan fazla:
Kod:
Class sqlquerier {
// Sıfırdan sorgu yazmak yerine
Bunu kullanın

.
. // 35 farklı yorumsuz fonksiyon
.
}
 
Sizce nasıl not edeyim? Ayrı bir yere mi not alayım yoksa programın içine mi yazayım? Çok karışıklık yaratır mı programda not etmek?
İlk önce yol haritası belirlenir ve konulara göre deftere güzel not alınır. Günde bir kere yazdıklarını tekrar eder ve okursun ve bilgisayardanda tekrar eder, örnek sorular çözersin.

Ayrıca önemli metot, yöntemleri de not alarak arada tekrar eder ve gerekli yerlerde kullanırsın güzelce.
 
Çalışırken koda yorum eklemekte sorun olmaz ancak normalde code içinde comment miktarı minimum olmalıdır, değişken isimleri, method isimleri vb. koda bakınca nasıl çalıştığını anlayacağımız şekilde ayarlanmalıdır. şu kod üzerinden örnek vereyim.


isSocketAvailable diye bir method ismi gayet güzel methodun ne iş yaptığını açıklıyor mesela.
Okunabilirliği arttırmak için iletişim soketinin bir başka fonksiyon tarafından kullanılıp kullanılmadığını kontrol eden bir method eklenebilir, müsait mi kontrolü yapan method eklenebilir vb.

Yani
function isSocketAvaible() {

içinde
checkIfSocketIsBeingUsed
checkIfSocketIsAvailable
vb. method isimleri ile kontroller konur.

bu methodun görevi socketin available olup olmadığını kontrol etmektir. 1 saniye bekleyin tekrar deneyin tarzı bir kural burayı değil, methodun çağrıldığı yeri ilgilendirir. isSocketAvaible methodunu çağırdığımız yerde 1 saniye aralıklarla available olana kadar retry yaparak çalışan bir döngü konabilir ya da bu döngüyü waitUntilSocketIsAvailableThenGetSocket (güzel salladım) gibi bir methodun içinden çağrılabilir. Yani method isimleri ile koda comment eklemenin önüne geçilebildiği müddetçe comment eklenmemelidir.
 
Not alman gerekmez. Kod sadece senin anlayacağın bir şeyse, aklında tut. Ortak bir şeyler yapıyorsan, kaynak kod içerisine bilgilendirme eklemeyi unutma.
 
Bu siteyi kullanmak için çerezler gereklidir. Siteyi kullanmaya devam etmek için çerezleri kabul etmelisiniz. Daha Fazlasını Öğren.…