🚀 HTML Comments: Kodun Görünmez Kahramanları

Kodun İçindeki Gizli Günlükler

Selamlar. Bugün teknikten ziyade, geliştirme kültürünün en önemli parçalarından birine, Yorum Satırlarına (Comments) değineceğiz. HTML'de yorum satırları <!-- Buraya yorum yazılır --> şeklinde oluşturulur. Bu satırlar tarayıcı tarafından okunur ama asla ekrana çizilmez (render edilmez).

Bunu bir oyunun 'Developer Console'u veya kodun içine bıraktığınız 'Post-it' notları gibi düşünebilirsiniz. Neden mi kritik?

  1. Organizasyon: Yüzlerce satırlık bir HTML dosyasında hangi bölümün 'Header', hangisinin 'Footer' olduğunu bulmak bir süre sonra imkansızlaşır. Yorumlar, kodun içinde tabelalar oluşturmanızı sağlar.
  2. Takım Çalışması: Biz Ovid Game bünyesinde çok oyunculu projemiz Car Crasher üzerinde çalışırken, UI (arayüz) katmanlarını birbirinden ayırmak için yorumları bir standart olarak belirlemiştik. Bir arkadaşım kodu devraldığında "Burası skor tablosu bölümü" notunu görünce vakit kaybetmeden işine odaklanabiliyor.
  3. Hata Ayıklama (Debugging): Bir kod bloğunun sayfayı bozduğundan şüpheleniyorsanız, onu tamamen silmek yerine yorum içine alarak 'geçici olarak devre dışı' bırakabilirsiniz.

Performans Endişesi?

Çok sorulur: "Dosyamda binlerce yorum satırı olsa site yavaşlar mı?" Teknik olarak hayır. Tarayıcının Rendering Engine'i, Render Tree oluştururken yorum düğümlerini atlar. Dosya boyutu birkaç bayt artsa da, kullanıcı deneyimine etkisi sıfıra yakındır. Yine de üretim aşamasında (production) genellikle bu yorumlar 'minify' edilerek temizlenir.

🚀 Sanal Kodlama Alanı Yükleniyor...

Dikkat Edilmesi Gereken Küçük Bir Detay

Yorum satırları ekranda görünmese de, dökümanın kaynağına (Sayfaya sağ tıklayıp 'Kaynağı Görüntüle' diyenler) bakan herkes bu yorumları görebilir. Bu yüzden yorum satırlarına asla şifre, gizli API anahtarları veya müşteriye yönelik özel eleştiriler yazmayın.

Profesyonel bir geliştirici, yorum satırlarını 'Neden' sorusuna cevap vermek için kullanır. Kodun 'Ne' yaptığını zaten kodun kendisi anlatmalıdır.

Bir sonraki dersimizde, web sayfalarının renklendiği ve canlandığı asıl bölüme, HTML Colors konusuna geçeceğiz. Hazır olun, paletleri çıkarıyoruz!

Geliştirici Notu: ovidgame.com