TLDR Sayfaları

TLDR Sayfaları (İngilizce: TLDR Pages), man sayfalarına kıyasla daha basit ve erişilebilir olma amacı güden, özgür ve açık kaynak kodlu kollaboratif yazılım belgelendirme projesidir. Proje, gönüllüler tarafından yazılan, komut satırı araçları ve diğer bilgisayar programları ile ilgili yardım dosyalarından oluşur. Bir sayfa, tldr komutu ile çağırılabilir. Projenin ismi, birçok kullanıcının çok uzun olduğunu söylediği man sayfalarına atıfta bulunan, "çok uzun; okunmadı" için bir kısaltma olan TL; DR kelimesinden gelir.

Mart 2021 itibarıyla projenin GitHub'daki deposunda 30.000 yıldız ve 2.500 çatal bulunmaktadır.

Tarihçe 
Romain Prieto, kişisel bilgisayarının saat dilimine göre ilk commit'ini 8 Aralık 2013 tarihinde saat 19.56.16'da ünlü kod barındırma ve sürüm kontrol sitesi GitHub'a yolladı.

İlk başlarda projeye sadece bir avuç insan katkıda bulunuyordu. 2015'in sonunda, ismi belirsiz bazı Çince yayınların proje hakkında makale yayımlamalarının üzerine, TLDR sayfalarının GitHub'daki deposunun popülerliğinde, Swift gibi ünlü yazılım ve yazılım dillerini dahi geride bırakan hızlı bir artış yaşandı. 25 Aralık 2015'te proje küresel popülerlikte 3. sıraya yükseldi. 27 Aralık 2015 itibarıyla, 700 küsur tanesi bir haftada gelmek üzere depo 2700+ yıldıza ulaştı. Ertesi gün proje, Hacker News'in ön sayfasına yerleşti. Gönderinin ardından, projenin aldığı yıldız sayısı 3700+'ya ulaştı ve projenin kendisi Github'ın günlük popülarite listesinde ilk sıraya ulaştı.

Proje, 2017 yılının sonlarına doğru başka bir patlama daha gördü ve geçmişten bugüne kadar devam eden istikrarlı popülarite artışını korudu.

Biçimlendirme 
TLDR Sayfaları projesinin varsayılan biçimlendirme kullanımı, diğer birçok özgür yazılım ve dokümantasyon projesinde kullanılan popüler biçimlendirme dili Markdown'dır.

Projenin kendi özel {{token_syntax}} uzantısı olsa da, CommonMark tariflerine uyar. Hatta projenin kodu, projenin yüklü olduğu cihazların CommonMark ile tamamen uyumlu olmasını gerektirir.

Komut kullanımı 

- Bir komutun tipik kullanımını göster:

tldr command

- Linux için tar tldr sayfasını göster:

tldr -p linux tar

- Bir Git alt komutu için yardım al:

tldr git-checkout

- (Eğer alıcı önbellek oluşumunu destekliyorsa) Yerel paketleri güncelle:

tldr -u

Yazarlık 
TLDR Sayfaları, CommonMark biçimlendirmesini destekleyen tüm metin düzenleyicilerde yazılabilir.

Github'daki tldr-pages deposuna katkıda bulunmak için, Katılımcı Lisans Sözleşmesi'ni imzalaması ve kuraldan ziyade sayfaların basit yapısını korumak adına yardımcı bilgi niteliğinde olduğu söylenen proje yönergelerine uyulması gerekir.

Lisans 
Sayfalar, Creative Commons Attribution 4.0 Uluslararası Lisansı ile lisanslanırken scripts/ dizininin içeriği MIT Lisansı ile lisanslanmıştır. Projeye yapılacak her türlü katkı, Katılımcı Lisans Sözleşmesi'ne tabidir.

Ayrıca bakınız 

 Unix komutlarının listesi
 Man sayfası
 info
 apropos

Kaynakça

Dış bağlantılar 

 
 Demo 
 Depo 
 PDF belgesi 

Özgür yazılım
Teknik iletişim
Yazılım dokümantasyonu