The overview page feature of javadoc in Doclava has an issue where the working directory changes for the resulting overview HTML page but @docRoot is not appropriately updated to reflect this, causing links to external files (like images) to be broken.

Under javadoc normally, the output path of the overview page is in the destination directory. With Doclava, the file is added to reference/packages.html such that now all references need to use "../" to access files. Normally, using @docRoot would solve this problem but with Doclava @docRoot on the overview.html page is still set to ".".

It's unclear how to work around this issue other than to simply hardcode the path as "../" in order to put image files in overview.html.