Koddan Döküman Oluşturan Araçlar

Doxygen
  Doxygen Programının İnternet Sitesi http://www.stack.nl/~dimitri/doxygen/
  Doxygen Programı çizim aracı Grphviz Programının İnternet Sitesi http://www.graphviz.org/

Doxygen ve Grphviz Programının Eğitim Videosu

Sharpdox
C# için Koddan döküman oluştruma araçı Programının İnternet Sitesi http://sharpdox.de/en/


Diğer Dokuman Oluştruma Programları

Javadoc
ROBODoc
POD
TwinText

Dökümantasyon nasıl test edilir?

Dokuman testi kara kutu testinin bir parçasıdır!
Buradaki bir hata yazılımın içerisindeki hata gibidir!
Hazırlanan doküman çok temel yada çok karmaşık olmamalıdır.
Dökümanın Terminoloji incelenmelidir!
Okuyucular için yeteri kadar uygun mu?
Bilgiler düzenli bir sırada mı?
Kısaltmalar bir dizin içerisinde verilmiş mi?
Teknolojik bilgilere yer verildi mi?
Web sayfası,telefon num ve bilgilerin yer aldığı bir index var mı?
Yazılımın özellikleri tam olarak anlatılmış mı?
Verilen örnekler doğru olarak çalışıyor mu?


Dokümanı yazan kişi ile test eden kişi neden farklı kişiler olmalıdır?

Yazılım Dokümanı Test Soruları

Hangi şartlar altında çalışıyor?
Mac yada düşük özellikli bilgisayarlarda çalışıyor mu?
Hatalara ilişkin yardım bilgilerini içermelidir

Yazılım Dokümanında neler bulunur?

Text ve grafikler içermeli.
Uyarılar ve kayıt bilgileri içermeli
End User License Agreement (EULA)
Kurulum ve kurulmun ne şekilde yapılacağı
User’s manual
Online help
Örnekler uygulamalar
Hata mesajları

Yazılım Dokümanı

Günümüzde yazılımların yapılarının ve içeriklerinin artması ile birlikte yazılım dokümanları bir readme.txt olmaktan çıkmıştır.
Yazılım içeriğinin doğru anlatılması oldukça önemlidir.
Yazılım test uzmanı tarafından yazılım dokümanın test edilmesi gerekmektedir.

Önce Test

Test güdümlü yazılım geliştirme.
Önce yapılacak test yada testler belirlenir.
Kod testlerden geçilecek şekilde geliştirilir.
1. ve 2. adımlar tekrarlanır.
Kod bol miktarda refactor edilir.

 

Önce Test-Avantajları

Kod yazılmadan önce test programı yazılır. Bu sayede mevcut sorunların daha erkenden ortaya çıkması sağlanarak, daha güvenli bir yazılım gerçekleştirilmeye çalışılır.

Bu yöntemde testler yazılmaya başlandığı esnada aslında ne şekilde bir kod yazılacağı da belli bir ölçüde belirlenmiş olur.

Test işleminin önemli bir kısmı bu süreç içerisinde tamamlanır.

Formal Kod incelenmesi

Kodu yazan kişi sonuç testleri ile sorumlu değildir!
Yönetici kodların birleşim noktalarında meydana gelebilecek aksiliklere ve hatalara karşı dikkatli olmalıdır.
İnceleme sonrasında rapor hazırlanmalı ve hatalar bulunmuş ise bulunun hatalar yeniden gözden geçirilerek düzeltilmelidir.
Bu yöntem sıklıkla kullanılan ve hata bulmak için oldukça faydalı bir yöntemdir.