# Yorum Satırları (Comments)

Dart, tek satırlık yorumları, çok satırlı yorumları ve belgelendirme yorumlarını destekler.

### Tek Satırlık Yorumlar

Tek satırlık bir yorum, <mark style="color:blue;">//</mark> ile başlar ve satırın sonu arasındaki her şey Dart derleyicisi tarafından görmezden gelinir.

```dart
void main() {
  // TODO: soyut bir LamaSelamlamaFabrikası'na refaktör yapılacak mı?
  print('Lama çiftliğime hoş geldiniz!');
}
```

### Çok Satırlı Yorumlar

Çok satırlı bir yorum,  <mark style="color:blue;">/\*</mark> ile başlar ve <mark style="color:blue;">\*</mark>*<mark style="color:blue;">/</mark>*  biter ve arasındaki her şey Dart derleyicisi tarafından görmezden gelinir (ancak yorum belgelendirme yorumu değilse; bir sonraki bölüme bakınız). Çok satırlı yorumlar iç içe geçebilir.

```dart
void main() {
  /*
   * Bu çok iş. Tavukları beslemeyi düşünün.

  Lama larry = Llama();
  larry.besle();
  larry.egzersizYap();
  larry.temizle();
   */
}

```

### Belgelendirme Yorumları

Belgelendirme yorumları, <mark style="color:blue;">///</mark> veya <mark style="color:blue;">/\*\*</mark> ile başlayan çok satırlı veya tek satırlı yorumlardır. Ardışık satırlarda <mark style="color:blue;">///</mark> kullanmak, çok satırlı bir belgeleme yorumunun aynı etkiye sahip olmasını sağlar.

```dart
/// Güney Amerika'da evcilleştirilmiş bir devekuşu (Lama glama).
///
/// Andean kültürleri, lamaları Hispanik zamanlardan beri et ve yük hayvanı olarak kullanmıştır.
///
/// Diğer hayvanlar gibi, llamanın da [Besle] fonksiyonu ile biraz [Yiyecek]e ihtiyacı vardır.
class Lama {
  String? ad;

  /// Lamanıza [yiyecek] ile yem verir.
  ///
  /// Tipik bir lama haftada bir balya saman yer.
  void besle(Yiyecek yiyecek) {
    // ...
  }

  /// Lamanıza bir [aktivite] ile [zamanSınırı] dakika boyunca egzersiz yaptırır.
  void egzersizYap(Aktivite aktivite, int zamanSınırı) {
    // ...
  }
}
```

Sınıfın oluşturulan belgesinde, \[besle] bağlantıları besle metodunun belgelerine ve \[Yiyecek] bağlantıları Yiyecek sınıfının belgelerine yönlendirilir.