*Onur Yerlikaya*, canlı örneklendirme linkin için teşekkürler. *Buray Usgurlu*, detaylı açıklamaların için teşekkürler. Burağın söylediklerinin yanında online demosunu gittigidiyor.com 'un API bölümünde görebiliriz. 223 sayfalık bir Kurumsal Servisler Dökümanı oluşturulmuş. Bunun yanında akış şemalarıyla da daha da anlaşılır olmasını çok beğendim açıkcası.
Akış Şemalarından bir tanesi: http://dev.gittigidiyor.com/asset/doc/updateProductDiagram.png *Mustafa Şengül*, PHP Manual 'i bende başarılı buluyorum. Gerçekten güzel belgelendirilmiş. Şimdi gözümde PHP Manual ve GittiGidiyor'un belgelendirme çalışmalarını gözümde canlandırdığımda -bir yerde okuduğum bir ifade ile- "Tek kişilik Dev Kadro" ile yazılım geliştiren kişilerin bunun yanında böyle belgelendirme hazırlamaları bayağı bir zaman ve emek gerektirmesi. 27 Mayıs 2010 19:36 tarihinde Burak USGURLU <[email protected]> yazdı: > Merhaba, > Yazılım belgeleme konusunda yazılım geliştirme aşamaları bazında ve yazılım > projesi bazında birçok belge üretilebilir... SWEBOK[1] yazılım mühendisliği > konusunda önemli bir kaynaktır. Burada yazılım geliştirme süreçleri > irdelenmiştir ve bu süreçler için, sırasında ve sonrasında üretilebilecek > belgeler, ilgili standartları referans gösterilerek verilmiştir. Aşağıda > aklıma gelen birkaç belgeyi listeliyorum... > > + Sistem tanımı/kullanıcı gereksinimleri > + Sistem gereksinimleri tanımları > + Yazılım gereksinimleri tanımları > + Kavramsal modelleme belgeleri > + Sistem tasarım tanımları > + Test planı > + Test raporları > + Kabul test raporu > + Son kullanıcı kullanım kılavuzları > + Sistem yöneticisi kullanım kılavuzları > + Kalite planları > > Kod içinde yapılan belgelemede bu belgelerin bir parçasıdır. > > Proje konusunda ise öncelikle ve tepede Proje planı olmak üzere buna bağlı > alt planlar oluşturulabilir. Aslında bu plan diğer mühendislik proje > planları ile benzerdir. Proje planında çalışma planı, iş kırılım ağacı, > belki bir gantt chart, risk planı, bütçe, vb. olabilir. Proje yönetim ve > planları konusunda temel kaynakda PMBOK [2] olarak gösterilebilir. > > Konu aslında oldukça derin. Belgelemeler genellikle proje büyüklüğü ve > projeyi yapan kurumun olgunluğu (CMMI veya ISO 15504 ile ölçülebilir > bunlarda), yazılım mühendisliği süreçlerini nasıl ele aldığına göre değişir. > > Umarım fikir vermiştir... > > Burak > > [1] http://www.computer.org/portal/web/swebok/html > [2] > http://en.wikipedia.org/wiki/A_Guide_to_the_Project_Management_Body_of_Knowledge > > > _______________________________________________ > Linux-programlama mailing list > [email protected] > https://liste.linux.org.tr/mailman/listinfo/linux-programlama > Liste kurallari: http://liste.linux.org.tr/kurallar.php > >
_______________________________________________ Linux-programlama mailing list [email protected] https://liste.linux.org.tr/mailman/listinfo/linux-programlama Liste kurallari: http://liste.linux.org.tr/kurallar.php
