Selamlar,
1 aydan uzun bir süredir "Pardus Yazılım Geliştirme Süreçleri"ni belgeyebilmek
adına çeşitli çalışmalar yapıyoruz. Kodlama stilimizin belirlenmesinden tutun
da Apidoc yazma standartlarımıza, unittest hazırlamanın ince detaylarına kadar
bir çok konuda belge üretmiş olduk. Bu dokümanların arasında en önemlisi
olarak gördüğüm ve Yazılım Geliştirme Sürecimizi mümkün olduğunca
tanımlayabilecek ana bir doküman da bulunuyor.
Biraz detaylardan bahsetmek gerekirse;
- Kod Standartları için Google'ın Python Kod Standartları dokümanını [1]
temel aldık. Hatta bu belgede çok az şey değiştirdik. [2]
- Api dokümantasyonunda temel hedef Sphinx [3] ile uyumlu bir şekilde
çalışabilecek standartlar ortaya koymaktı. [4]
- Unittest [5]'lerin hazırlanması için Pytest [6]'ten yararlanmaya karar
verdik. [7]
- Yazılım Geliştirme Süreçlerimiz için bu konuda edindiğimiz bilgi/birikime
dayanarak bir süreç çıkartmaya çalıştık. [8] Süreç standardı olarak "V
Şeklinde Geliştirme Süreci" [9] ile "Prototip Temelli Geliştirme Süreci"
[10] inin birlikte kullanılabileceği bir yol planı ortaya çıkarttık. [11]
- Bunların dışında geliştiricilerin işlerini kolaylaştırmak adına, konuları
ile ilgili bir çok kopya kağıdı (cheatsheet) hazırladık:
- Apidoc CheatSheet [12]
- UnitTest CheatSheet [13]
- PythonStyle CheatSheet [14]
Bu çalışmaların neticesinde daha kaliteli, daha uzun ömürlü ve daha programlı
bir şekilde yazılım geliştirebileceğimizi düşünüyoruz.
Bu belgeler ışığında yeni işler ortaya çıktı tabi ki;
- Bu belgelerin tümünü Türkçe'ye çevirilmesi gerekiyor, ana dokümanın büyük
bir kısmı çevirlmiş durumda [15] developer.pardus.org.tr'nin Türkçe desteği
ile çalışacak bir versiyonunu gelistirici.pardus.org.tr adresinde
açabiliriz.
- Bu dokümanlarda son kararı verdikten sonra mevcut yazılımlarımızı [16] bu
standartlara uygun hale getirmemiz gerekiyor.
- Kodların kodlama standartları dokümanına uygun şekilde güncellenmesi,
- Apidoc'ların yazılması,
- Unittest'lerin yazılması,
- Tüm belgeler için ayrıca standart bir belge şablonu hazırlanması gerekiyor,
bu belgelerin bir Pardus belgesi olduğunu anlamamıza olanak sağlayacak
güzel bir sayfa düzeni (Pardus antetli kağıdı diyelim :)) Hatta bunun bile
belgesi yazılabilir.
Tüm bunlar için gönüllü olan/olacak insanları bekliyoruz ;)
Ayrıca belirtmeliyim ki bu belgeler kesin çizgiler ile belirlenmiş kararları
yansıtmıyorlar, üzerinde tartışabilir ve değişiklikler yapabiliriz.
[1] http://google-styleguide.googlecode.com/svn/trunk/pyguide.html
[2] http://goo.gl/FKKKr
[3] http://sphinx.pocoo.org/
[4] http://goo.gl/HYeeS
[5] http://en.wikipedia.org/wiki/Unit_testing
[6] http://doc.pytest.org/en/latest/
[7] http://goo.gl/9ELcc
[8] http://goo.gl/jv8sS
[9] http://en.wikipedia.org/wiki/V-Model_(software_development)
[10] http://en.wikipedia.org/wiki/Software_Prototyping
[11] http://goo.gl/CQ4FA
[12] http://goo.gl/FaJ4k
[13] http://goo.gl/hryYs (PDF'inde bir sorun var, rst linki)
[14] http://goo.gl/tOLIX
[15] http://goo.gl/rQ1Qw
[16] http://svn.pardus.org.tr/uludag/trunk/
p.s. linkler biraz uzun olduğu için goo.gl kullanmak durumunda kaldım.
İyi eğlenceler,