Pardus Belgelerini Taşıyoruz 16/10/2006, Monday - 21:30

Eğer teknik konulara kafa yormadan Pardus'a yardım etmek istiyorsanız ve Wiki kullanmayı biliyorsanız, "bana belgenin adresini ver, ben onu Wiki'ye taşırım" diyorsanız size bir sürprizimiz var. Böyle bir sürpriz'i neden yaptığımızı merak edenler ayrıntıları okyabilirler, fakat doğrudan işe girişmek isteyenler için yardım etmek isteyen bir kişinin ne yapması gerektiğini hemen yazıyorum:

Aşağıdaki liste düzenli olarak güncelleniyor. Hangi belge ile kimsenin ilgilenmediğini ve belgenin orjinalini nerede bulabileceğiniz görebilirsiniz. Eğer herhangi bir belgeyi gözünüze kestirirseniz, sizden istediğimiz şeyi, yani, orjinal adresi verilen belgeyi, burada verdiğim isim ile pardus-wiki.org'a taşımayı kabul edereniz yapmanız gereken şey meren at pardus.org.tr daresine bir e-posta atarak "taşınmayı bekleyen belgeler arasından hangi belgeyi taşımak istediğinizi", "adınızı", "soyadınızı" ve "en sevdiğiniz yemeği" yazmak. Ben de e-postanıza yanıt yazıp günlük girdisini güncelleyeceğim (istenenlerden herhangi birisinin eksik olması kabul edilemez).

Şu ana kadar taşınmış ya da taşınmakta olan belgeler:

Bilişim Okur Yazarı - Uğur Çetin tarafından taşındı (Sn. Çetin'in en sevdiği yemek, makarna).
Kuluçka Dağıtım Seçimi - Uğur Çetin tarafından taşındı.
Proje Ana Sözleşmesi - Mustafa Durmuş tarafından taşındı (Sn. Durmuş'un en sevdiği yemek, kuru fasulye).
Sözlük Kılavuzu - Deniz Silahcılar tarafından taşındı (Sn. Silahcılar'ın en sevdiği yemek, makarna).
Actions API - A. Murat Eren tarafından taşındı (Eren'in en sevdiği yemek, pilav).
ÇOMAR Mimarisi - Emre Sağlam tarafından taşındı (Sn. Sağlam'ın en sevdiği yemek, bamya (biz de inanamadık)).
Pardus Depo Politikası - Deniz Silahcılar tarafından taşındı (Sn. Silahcılar'ın en sevdiği diğer yemek, mantı).
Kaynak Temizleme Kılavuzu - Emre Sağlam tarafından taşındı (Sn. Sağlam'ın en sevdiği yemek, peruvian chicken rotisserie (halâ inanamıyoruz)).
Pardus Açılış Sistemi - Arda Çetin tarafından taşındı (Sn. Çetin'in en sevdiği yemek, balık).
Yeni Geliştirici Kılavuzu - Bahadır Kandemir tarafından taşındı (Sn. Kandemir'in en sevdiği yemek, yeşil mercimek).
Grafik Arayüz Tasarım Kılavuzu - Deniz Silahcılar tarafından taşındı (Sn. Silahcılar'ın en sevdiği diğer yemek, mercimek çorbası).
PiSi Mimarisi - Barış Metin tarafından taşınıyor (Sn. Metin'in en sevdiği yemek, karpa).
Nasıl Yardım Ederim - Çağlar Ateş tarafından taşınıyor (Sn. Ateş'in en sevdiği yemek, zeytinyağlı dolma).

Taşınmayı bekleyen belgeler:

Taşınmayı bekleyen belge yok

 

 

Belge üretmenin açık kaynak kodlu projelerin en ciddi problemlerinden birisi olduğuna inanıyorum. Açık kaynak kodlu bir proje olan Pardus'un da bu konuda herhangi bir sıkıntısı olmadığını iddia etmek doğru olmaz.

Geliştiricilerin yoğunlukları ve vakit sıkıntıları yaptıkları iş ile ilgili belge üretmelerini engelliyor. Belge yazacak kadar uygulamayı tanımayı başarmış ve incelemiş birisinin kendisini tutamayıp koda saldırmasının önüne geçilemiyor, bu yüzden uygulamanın geliştiricisi olmayanların belge yazmasını beklemek çok güç oluyor. Bu koşullarda kesinlike belge yazımını, güncellenmesini ve okunmasını mümkün olduğunca kolay hale getirmek gerekiyor ki, zaten zor olan bir süreç korkunç bir hâl almasın.

Pardus projesi olarak belgelerimizi bu güne kadar LyX ile hazırlıyorduk. Geliştirici listesinde de dile getirdiğim gibi, Gürer LyX belgelerimizi web sayfaları ile entegre etmek için güzel ve "çalışan" bir sistem oluşturmuştu zamanında. Fakat bir kaç nedenden ötürü bu sistemi bir türlü etkin bir şekilde kullanamadık.Çünkü belgeler yazıldıktan sonra SVN'e commit ediliyor, belgeyap.py çalıştırılıyor ve sonra da web sitesinin kendisini SVN sunucusundan güncellemesi bekleniyordu. Çok basit ve kolay adımlar olsa da iş belge üretimine gelince bunlar hendek-deve ilişkisi sergilediler.

Biz de belgelerimizi Wiki'ye taşımaya karar verdik, zaten hem kullanıcılar hem de geliştiriciler için bir kaç belgemiz halihazırda wiki'de idi (SSS, PiSi - Hello World, PiSi Paketi Nasıl gibi). Neden tümünü taşımayalımdı (içimizdeki Oğuz Atay sevgisi bambaşka). Birlikte çalışılabilirlik, kategorizasyon, sürüm takibi, yetkilendirme gibi konularda sağladığı kolaylıklar ve Wikipedia ile kendisini ispatlamış olan MediaWiki'nin bize bir sorun çıkarmayacağını düşündük. Ben de boş durmayıp bunu yaparken, kimin en çok hangi yemeği sevdiğini öğrenmenin harika bir fikir olabileceğini düşündüm.

Kaptanlığını Ahmet Aygün'ün yaptığı Wiki'ye belgelerimizi taşıdıktan sonra hem u18a çalışmalarının hem de belgelerin güncellenme işlerinin daha hızlı ve kolay olacağını umuyorum. Wiki'den diğer formatlara dönüşüm ile ilgili de bir kaç hack yaptıktan sonra hiç bir problemimiz kalmayacak muhtemelen...


Tags: pardus  belgeler 

Comments

Post a comment

Your name: Comment:
Number of remaining characters: