In a multi-project environment with modules that again have modules (project/module1/module1A) the <menu ref='parent'> not only creates the direct parent but all parents (see issue
MSITE-136) what seems perfect to me.
Anyways only the link of the direct parent works for me. All other links are broken. I use "mvn site:stage -DstagingDirectory=<absolutePath>".
If I use -DstagingDirectory=/foo/bar then the link for "module1" is "/foo/bar/<staging-crap>/module1/index.html" what is correct. But the link for "project" is "/foo/<staging-crap>/index.html" but it should be "/foo/bar/<staging-crap>/index.html".
Besides I do NOT want to have the "<staging-crap>" what is automatically produced from the "<distributionManagement>" of the POM, but is required for site:stage to work.