Template suggestion: ordering of function doc sub-sections

[jrfnl]

Template issue/request

This is just a suggestion. I know I will be able to overload specific partial template layouts myself to handle this for the documentation I'm working on, but I figured I'd open an issue to discuss this, just in case other people may think this could be a good idea as well.

Ok, so, currently the method docblock is ordered like this:

1. Summary
2. Signature
3. Description
4. Parameters
5. Tags
6. Return values

Now, in case there are several arbitrary tags, this moves the "Return" section quite far down from the parameters and the function signature, making these feel disconnected.

Aside from that, while not strictly a return value, the exceptions thrown are shown under "Tags", while to me it would make more sense to show them either in a separate block section or in a sub-section of the "Return" section.

So, I was wondering how people would feel about a re-ordering like this:

Opinions ?