Think about rearranging sections

[jimhester]

A frequent complaint about R documentation is that the examples are at the very end of the documentation, and often people learn best by example.

Perhaps rdoc could move the examples section to just below the description? Maybe controllable by an option if people want to preserve the default ordering.

[mdequeljoe]

thanks - great idea! I think it would indeed be good to have an option for this re-arrangement.