Django‘nun geliştiricilerinden Adrian Holovaty ve Jacob Kaplan-Moss, bir kitap yazdılar: Django kitabı. Kitap internet üzerinden açık, ayrıca basılı hali de satılıyor. Çok ilginç bir süreci var bence. Kitabı ortaklaşa yazdılar ve internet sürümünden anlaşılacağı üzere bir sözdizimi var. Yazılar çok hoş bir arayüzle gözüküyor. Örneğin kodlar, yeşil kutularda ve farklı fontta gözüküyor. Site o kadar sade, güzel ve işlevsel ki! Sadece yazarlar değil kitabın sahibi, okurlar da katkıda bulundu. İlk önce beta sürümünü bölüm bölüm yazdılar. Her paragrafın solunda tıklanabilen ve açılabilir pencerede gözüken yorum görme ve ekleme kısımları var (bakınız: yandaki resim). Buraya okurlar o paragraf ile ilgili yorum ekleyebiliyorlar. Okurken kitap kibi okuyup, isterseniz yorumlara bakabiliyorsunuz; yani çok ince ama önemli bir ayrıntı. En sonunda bu yorumları da göz önünde bulundurarak kitabı bastılar.

Belki vardır diye baktım ama sitenin kaynak kodunu bulamadım. Viki gibi, yazarların değiştirebileceği, yorum eklenebilen neler var diye baktım. Ayrıca metin dosyasından html, latex, vb. üreten sistemlere de baktım:

  • Asciidoc: Metin tabanlı doküman oluşturma. Örnek sonuç burda. İçinde latex formülleri yazılabiliyor. Müzik notaları bile yazılabiliyor ama LilyPond ve ImageMagick gerekiyormuş. Birçok dilde kod renklendirici de var.
  • Deplate: Ruby tabanlı. Latex, docbook, html ve html sunumlarına çevrilebilen bir viki-sözdizimi varmış.
  • MATLAB anlatımı için MATLAB’ın kendi otomatik dokümantasyon sistemi var. Html, latex, word, vb. üretebiliyor.
  • Google docs var ama o da word gibi birşey. Formül yazmak, referans vermek falan ölüm.

Liste daha uzar ama burada keseyim. Şimdilik en mantıklısı LaTeX dosyalarını svn’de kullanmak gibi geliyor. Ama okurlardan geribeslenim almak için Django kitabının yorum sisteminin üzerine görmedim. Viki gibi olmasın, daha doğrusu sadece bu işi görsün istiyorum. Yok şu eklentiyi kurayım, yok bu desteği falan gereksiz işler. Böyle şeyler zaman da yiyor zaten.

Bir kenarda dursun; ders notu falan hazırlamak gerekince bir el atmak lazım. Hem pdf’i basılabilir, hem de internetten okunabilir. Kopyala yapıştır ile kodlar denenebilir. Okurlar/öğrenciler fikirlerini de girebilirler. Sizce de çok güzel bir dokümantasyon/eğitim yöntemi değil mi?