As I mentioned before- I really do prefer YUIDocs and that works really well with the options in this format (and we use it in marionette-js-client too)... I am willing to change it to make you happy but I think this format is more meaningful to me and in the context of generating userdocs.