SmartBear is presumably working diligently at adding comments to their nearly-comment-free, Javadoc-generated API documentation (https://www.soapui.org/apidocs/overview-summary.html). I'm wondering how many [more] years we have to wait for this to be finished? The current version is /nearly/ useless. You...umm, you are working on this, right?
and fwiw, happy holidays
Edited: link now to point to the free-version API rather than the Pro version
There should be human-written, descriptive words written for every item in the API docs (or at least all the important items...which is probably all of them). For example, on the base page I linked to before, in the Description column there should be a...umm, what's it called. Oh yes, a description. For every package listed. And when you navigate to a particular class or package, there should be words there, too. Words that help the user understand what all the objects, classes, and methods are for and what they do. Important classes should be well-documented, in particular. For example, https://www.soapui.org/apidocs/com/eviware/soapui/impl/wsdl/testcase/WsdlTestCase.html has only "TestCase implementation for WSDL projects" for documentation. Which I think is no longer even true (I think it's also used for WADL projects, yes?). And the only method that is documented is the moveTestStep method (and even that documentation could be better; what does a positive offset mean? what does a negative offset mean? what happens if you try moving a TestStep by an invalid offset (too large or too small)?).
