I'm a fan of the project websites generated by maven-site-plugin, but I've noticed over the years that there's a lot of moving pieces in the site generation phase.
Sometimes upgrading a reporting plugin will produce unexpected site changes, or it may be the interaction of several plugins, etc. Noticing after you've published is annoying. What are folks using to validate their sites programmatically? Are there plugins that bind to post-site and perform tests? Perhaps they spin up the site in Jetty? The only plugin I'm aware of is linkcheck, which is useful but not a comprehensive site validation tool. Greg Chabala