In running some preliminary Yetus-driven tests, it was found (with the help of Allen Wittenauer!) that we still dump the generate javadocs into docs/ instead of something like docs/target. This caused Yetus to get a bit confused when computing the effective diff of some patch being tested as suddenly there were tons of changes from the original repository.
We stopped bundling the javadocs in our tarballs a while back (which, in talking with Christopher Tubbs on IRC) is probably why they went to this non-standard location.
We should make sure our generated javadocs are being put in a sane location, likely the default location for the maven plugin itself is sufficient and update the docs with any amended steps.