I spot-checked the new website. Overall it looks good; couple of problems that I noticed:
* Missing images, e.g. see https://bookkeeper.staged.apache.org/docs/api/distributedlog-api https://bookkeeper.staged.apache.org/docs/deployment/dcos There are placeholders like "" where the images should be. The old site has the images. * I don't see links to the Javadoc even for the older versions but given your p.2 it doesn matter much. I briefly looked at javadoc.io and it looks like it only shows docs for the latest versions, do we have to publish snapshot artifacts to get "latest" javadoc? OTOH we can be ok with the docs for the released version only. On Fri, Mar 18, 2022 at 6:06 AM Nicolò Boschi <boschi1...@gmail.com> wrote: > Dear community, > The website (https://bookkeeper.apache.org/) is now updated with the > latest > releases (the latest website update was on May '21). > > I'd like to discuss a couple of points: > 1) The new Docusaurus website is live at > https://bookkeeper.staged.apache.org/. My plan would be to replace the > current as soon as possible. I haven't received feedback yet. I'd like to > set a deadline (two weeks?) and then deploy the new one. (thanks to GH > history we can easily rollback in case of issues) > > 2) Currently, Javadoc files are missing for the latest versions. In order > to improve maintainability, I propose to remove the javadoc from the > website files and use an external service such as javadoc.io. IIUC we just > need to push the JAR with the javadoc to Maven central. Then we have to > update links from the website. We could recover the missing javadoc > manually. > > Let me know what you think > > BR, > Nicolò Boschi > -- Andrey Yegorov
