computercoder #1 bbdoc is the Max standard way of doing the documentation, but I'm thinking if your way works well, why mess with it? However, you could supply it both ways if the demand is great enough. Honestly, either looks fine for me.