Document how to write testng tests.

[jamoore]

The switch to testng from junit is a very large shift. This needs to be better documented, in the form of a users guide/tutorial, etc.

See ​Omero Development

[jmoore]

Blazej, Mark: do you think this is "done"? :)

[mtbcarroll]

I have a feeling that I'm not managing to find the testng docs, though the OMERO developer docs do take a bit of hunting through...

[bpindelski]

I second Mark. We don't have extensive docs regarding writing unit/integration tests and what framework each component uses.

[hflynn]

Okay, I closed this because it had been ignored for 6 years but I'll reopen in the hope someone decides to do it one day!

[hflynn]

Removed link to contributing developer story as that is being used to manage docs which have split off into a separate section and apply equally to BF and OMERO. These testing docs belong within the OMERO (or BF as appropriate) docs.

[hflynn]

Is the work @cblackburn has been doing on documenting testing contributing towards this ticket, or is this a specific type of testing that we are still not covering in our docs?

[cblackburn]

My work on documenting pytest falls outside of this ticket - though the ticket has been around from before I was even here! - this ticket relates to Java tests which is sort of parallel to what I did with Python. Maybe Josh can comment if the documentation is better than 8 years ago? Maybe Mark and Blazej can comment on improvements in the last 12 months?

[jamoore]

It's certainly better! :) But from Blazej's comment:5, there's work to be done. I'd leave it in his hands to say when we've gotten there.

[bpindelski]

Closing this for the final time, as the overall team knowledge about tests has increased (and there will be a presentation outlining details). There is first of all ​http://testng.org/doc/index.html and the practice of test engineering isn't something one doc page could encompass. Additionally, test change together with the codebase, so it will be hard if not impossible to set up strict rules.