Hat jemand versucht, aus Ihren Gurkenszenarien Endbenutzer (möglicherweise online, möglicherweise gedruckte) Hilfe/Dokumentation zu erstellen? Oder Screenshots für den Einsatz in der Dokumentation mit der Fähigkeit von RSpec und Selenium RC gemacht?Mit Gurke oder RSpec + Selenium Endbenutzerdokumentation erstellen?
Für Gurken, ich stelle mir vor, so etwas wie:
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
in der Dokumentation zu übersetzen:
Wenn Sie einen Link hinzufügen möchten, gehen Sie zu dem Blog-Post Seite bearbeiten. Klicken Sie auf die Schaltfläche "add link" und geben Sie eine URL wie "http://stackoverflow.com" in das Feld URL der URL ein. OK klicken".
Wäre es meine Zeit wert sein, um zu versuchen und, für ein, schreiben Sie etwas meine Gurke Funktionen in der Dokumentation zu analysieren, und zwei, zu schreiben/Struktur meine Gurke Funktionen in einer solchen Art und Weise, wie eine gute Dokumentation zu erstellen? Würde die resultierende Dokumentation am Ende wirklich langweilig ohne viel Variation in der Struktur klingen?
Gibt es sonst noch etwas wie diese Idee? Doxygen sieht so aus, als ob es mehr für Code-Dokumentation als Endbenutzer-Dokumentation ist.
Was ist mit automatischen Screenshots? Dies scheint ein ertragreicherer Weg zu sein - verwenden Sie einfach den Code, der einen Screenshot erstellt, wenn ein RSpec-Test fehlschlägt, und nehmen Sie einen in vorgeschriebenen Situationen. Gibt es einen besseren Weg, dies zu tun?