[ 
http://jira.codehaus.org/browse/JBEHAVE-174?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Mauro Talevi updated JBEHAVE-174:
---------------------------------

    Description: 
Posted by Gerard Meszaros on wiki:

There seems to be a large gap between the Two-Minute Tutorial and the detailed 
technical documentation (JavaDoc). This gap created a lot of frustration. Each 
of the following issues may, for all we know, have good solutions in the 
product. We just couldn't find them! The Two-Minute Tutorial seemed to leave 
out a bunch of important stuff. We couldn't get the example to actually compile 
and run until we discovered this. The installation information was 
non-existant/incomlete. There was no mention of the need to have 
hamcrest-all-1.2.jar installed so we couldn't code the equalTo in the 
ensureThat. The use of Static Imports to allow these methods be referenced 
without class names on front should be highlighted in the example.

The link to the examples (which we are encouraged to review) is broken.

When running scenarios with Pending steps, the tests still run green. The 
documentation does say this can be changed but we were unsuccessful at doing 
it. It seems to be rather involved and/or voodoo. It would be good to have a 
very clear description of 1) Why it considers Pending steps as green and 2) how 
to cause the pending steps to fail the tests in various environments (e.g. 
Eclipse/Java)


  was:
Posted by Gerard Meszaros on wiki:

There seems to be a large gap between the Two-Minute Tutorial and the detailed 
technical documentation (JavaDoc). This gap created a lot of frustration. Each 
of the following issues may, for all we know, have good solutions in the 
product. We just couldn't find them! The Two-Minute Tutorial seemed to leave 
out a bunch of important stuff. We couldn't get the example to actually compile 
and run until we discovered this. The installation information was 
non-existant/incomlete. There was no mention of the need to have 
hamcrest-all-1.2.jar installed so we couldn't code the equalTo in the 
ensureThat. The use of Static Imports to allow these methods be referenced 
without class names on front should be highlighted in the example.

The link to the examples (which we are encouraged to review) is broken.

When running scenarios with Pending steps, the tests still run green. The 
documentation does say this can be changed but we were unsuccessful at doing 
it. It seems to be rather involved and/or voodoo. It would be good to have a 
very clear description of 1) Why it considers Pending steps as green and 2) how 
to cause the pending steps to fail the tests in various environments (e.g. 
Eclipse/Java)

We had trouble using numbers with decimal points in our specs because we were 
dealing with money. We tried declaring parameters as BigDecimal but could not 
get this to work. It should be possible to do this out of the box with no extra 
effort as it is a pretty common need.


> Improve documentation 
> ----------------------
>
>                 Key: JBEHAVE-174
>                 URL: http://jira.codehaus.org/browse/JBEHAVE-174
>             Project: JBehave
>          Issue Type: Improvement
>    Affects Versions: 2.2
>            Reporter: Mauro Talevi
>            Assignee: Mauro Talevi
>             Fix For: 2.3
>
>
> Posted by Gerard Meszaros on wiki:
> There seems to be a large gap between the Two-Minute Tutorial and the 
> detailed technical documentation (JavaDoc). This gap created a lot of 
> frustration. Each of the following issues may, for all we know, have good 
> solutions in the product. We just couldn't find them! The Two-Minute Tutorial 
> seemed to leave out a bunch of important stuff. We couldn't get the example 
> to actually compile and run until we discovered this. The installation 
> information was non-existant/incomlete. There was no mention of the need to 
> have hamcrest-all-1.2.jar installed so we couldn't code the equalTo in the 
> ensureThat. The use of Static Imports to allow these methods be referenced 
> without class names on front should be highlighted in the example.
> The link to the examples (which we are encouraged to review) is broken.
> When running scenarios with Pending steps, the tests still run green. The 
> documentation does say this can be changed but we were unsuccessful at doing 
> it. It seems to be rather involved and/or voodoo. It would be good to have a 
> very clear description of 1) Why it considers Pending steps as green and 2) 
> how to cause the pending steps to fail the tests in various environments 
> (e.g. Eclipse/Java)

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: 
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

---------------------------------------------------------------------
To unsubscribe from this list, please visit:

    http://xircles.codehaus.org/manage_email


Reply via email to