It would be nice if you could add additional documentation to the generated table output.
This way you can add a story about the specific table, It differs from the table comments because they seems to be more useful for a small description.
I made a small patch for this feature where you can add html documents in an Extra directory. The naming of the document is tablename_top.html or tablename_bottom.html.
The html will be inserted (on top or borttom postion) in the generated output buy a small JQuery script if found.
It is a bit hackish but it works nice for me.