Added test for Nested annotation.
Start at root for annotation checking.

And added a comment on how it probably should be changed.
Update comments on setlock

Make it obvious that timeout value is milliseconds.
Add more meaningful timeout/retry values to tests
Fixed typos in comments.
Change example to use generic Container.

More in line with what developers should use and also what’s in the
documentation.
[JBTM-2165] Make CMR synchs interposed so that they are ordered ater session synchs
Added potential TODO around State annotations

https://issues.jboss.org/browse/JBTM-2176
More changes to align with STM documentation.
Fixed typo in comment.
Added example for STM doc to reference.
Added the STM docs to the website building scripts