Note that there are some explanatory texts on larger screens.

plurals
  1. POUsing Cucumber or RSpec+Selenium to create end user documentation?
    primarykey
    data
    text
    <p>Has anyone tried creating end user (potentially online, potentially to be printed) help/documentation out of your cucumber scenarios? Or taken screenshots for use in documentation using RSpec and Selenium RC's ability to do so?</p> <p>For Cucumber, I'm imagining something like:</p> <pre><code>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 </code></pre> <p>Translating to the documentation:</p> <blockquote> <p>If you want to add a link, go to the edit blog post page. Press the "add link" button and type a URL, like "<a href="http://stackoverflow.com">http://stackoverflow.com</a>", into the link URL field. Click "OK".</p> </blockquote> <p>Would it be worth my time to try and, for one, write something to parse my Cucumber features into documentation, and two, to write/structure my Cucumber features in such a way as to create good documentation? Would the resulting documentation end up sounding really boring without much variation in the structure? </p> <p>Is there anything else out there like this idea? <a href="http://www.stack.nl/~dimitri/doxygen/" rel="noreferrer">Doxygen</a> looks like it's more for code documentation than end-user documentation.</p> <p>What about automatically taking screenshots? This seems like a more fruitful path-- just reuse the code that takes a screenshot when an RSpec test fails and have it take one in prescribed situations. Is there a better way to do this?</p>
    singulars
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload