Salatalık senaryolarınızda son kullanıcı (potansiyel olarak çevrimiçi, potansiyel olarak yazdırılabilir) yardım/belge oluşturmayı deneyen var mı? Veya RSpec ve Selenium RC'nin bunu yapma becerisini kullanarak dokümantasyonda kullanmak için ekran görüntüleri çekildi mi? belgelere çevirmeSon kullanıcı belgelerini oluşturmak için Salatalık veya RSpec + Selenium kullanma?
Scenario: If you want to add a link
Given I am on the edit blog post page
When I press the "add link" button
And I type in a link URL "http://stackoverflow.com"
And I click "OK"
Then the blog post should have 1 link
: Salatalık için
, şöyle bir şey hayal ediyorumbenim zaman iyi belgelerine oluşturmak için böyle bir şekilde/yapısını benim Salatalık özelliklerini yazmaya, iki deneyin ve, biri için, dokümantasyon içine benim Salatalık özelliklerini ayrıştırmak için bir şeyler yazmak ve değer olurdu? Sonuçta elde edilen belgeler, yapıda çok fazla değişiklik olmadan sondaj yapmaktan sıkıcı olur mu?bir bağlantı eklemek istiyorsanız, düzenlemek blog yazısı sayfasına gidin. " bağlantısını" düğmesine basın ve "http://stackoverflow.com" gibi bir URL'yi bağlantı URL alanına yazın. "Tamam" ı tıklayın.
Bu fikir gibi başka bir şey var mı? Doxygen, son kullanıcı belgelerinden daha fazla kod belgelerine benziyor.
Ekran görüntülerini otomatik olarak alma hakkında ne düşünüyorsunuz? Bu daha verimli bir yol gibi görünüyor - sadece bir RSpec testi başarısız olduğunda bir ekran görüntüsünü alan kodu alıp önceden belirlenmiş durumlarda bir tane alsın. Bunu yapmanın daha iyi bir yolu var mı?