For Package documentation in Javadoc we should use package-info.java rather than package.html.
It is important to know that the description needs to be done in front of the package statement as otherwise Javadoc is not able to find the description. This was a mistake done in the past (why actually package.html got reintroduced).