Awwww, Maven, you kill me, you really do!!
You maintain your Maven project its documentation in a simple XML dialect called xdocs. It's then transformed to HTML and copied to the project its website. A colleague updated documentation and then did a "maven multiproject:site site:deploy". He saw that the generated HTML documentation wasn't updated. Except it was. Look at the following source:
<?xml version="1.0" encoding="utf-8"?> <document> <properties> <title>Release notes</title> </properties> <body>
<subsection name="SuperProject-2.5.2-build04.ear"> .... </subsection>
<section name="Releases SuperProject">
<subsection name="SuperProject-2.5.1-build01.ear"> ... ...
Notice the error? The <section> tag is placed below the <subsection> tag. Why in hell this validates is unclear to me. Is it validated in the first place? TELL ME IT IS!! Another manhour or two wasted.