Observations of Doxia Menu Inheritance

I couldn't find much/any documentation on inheriting menus from a Super POM using Doxia + Maven 2. Here is a quick overview of what I think I have learned using a small reference example to illustrate.

Project Layout

superproject
|
+- src/site/site.xml
|
\- module1
 |
 \- src/site/site.xml

Super Module site.xml Content

<?xml version="1.0" encoding="UTF-8"?>
<project name="${project.name}">
<body>
1   <menu ref="parent" inherit="top"/>
  
  <menu name="Super Menu">
      <item name="Parent A" href="parenta.html"/>
      <item name="Parent B" href="parentb.html"/>
  </menu>

2   <menu ref="modules" inherit="bottom"/>
3   <menu ref="reports" inherit="bottom"/>
  </body>
</project>

Sub Module site.xml Content

<?xml version="1.0" encoding="UTF-8"?>
<project name="${project.name}">
 <body>
4   <menu name="Menu A" inherit="bottom">
       <item name="Link 1" href="link1.html"/>
       <item name="Link 2" href="link2.html"/>
   </menu>
5  <menu ref="reports" inherit="bottom"/>

   </body>
</project>

So what does all this mean?

interitance="top|bottom" - put a menu node before or after sub module's menu items
1 - will only be visible and have content in sub modules
2 - will only be visible and have content in super modules
3 - put reports at the bottom of all modules
4 - inherit="bottom" is not completely clear to me, but either top or bottom is required for the menu to show up
5 - I wanted project reports to always be at the bottom of the menu and could not figure it out without explicitly putting it there; this seems to override the report menu specified in the super site.xml.

Please correct me if I'm wrong about any of these observations/assumptions, and point me to documentation if you know of any. Otherwise, I hope this helps somebody.