Hi Brian, That will be a boon to developers who want's to get started with integration tests. In addition we can also have brief documentation about itests itself or FAQ about itest. Few things those can be included are What are itests?, How to create &configure a new itest module? so that surefire plugin can execute the tests successfully. Thanks, Venu.
On 8/16/07, Brian Murray <[EMAIL PROTECTED]> wrote: > > I'd like to take a crack at expanding the Javadoc in the sca itests, and > I'd like some feedback on the benefit and conventions of doing so. > > I've noticed that the Javadoc in the sca/itests could be enhanced (or in > many cases is absent altogether). Javadoc seems to me a great way to > document the intent of the test cases. Including the package.html and > overview.html files will allow a single source of documentation. This > will > allow us to more easily assess test coverage of concepts (rather than > merely > API's). > > As for javadoc conventions: > > I'd like to add javadoc to the src/test subdirectories. This is where we > would document the scenario being tested. (e.g. Attempt to locate a > service > with an invalid name.) > > I'd like to add javadoc to the src/main subdirectories to describe the > requirements on the services (e.g. This must be a composite within a > composite....) for the test case scenario to be achieved. > > Please let me know if you'd like me to add or subtract from the above. > -- ----------------------------------------------------------------------------------------------------- A 'wish' changes nothing. A 'decision' changes everything! ---- Anon Even if you're on the right track, you'll get run over if you just sit there.---- Will Rogers
