This was deliberate. We will eventually need to find a better way to link separate sets of documentation. Apache Cocoon has this same issue.
Yes, this is currently a maintenance nightmare ATM. Any improvment here would be hightly appreciated!
--
Reinhard Pötz Independant Consultant, Trainer & (IT)-Coach
{Software Engineering, Open Source, Web Applications, Apache Cocoon}
web(log): http://www.poetz.cc --------------------------------------------------------------------