Again, we should first have the discussion as to which tool we want to use and what format it requires and then make the changes in all widgets. We are already using a documentation parser (https://github.com/visionmedia/dox) that supports Markdown, so that would be our primary candidate. Therefore, I'd like us to switch to the current format.

I think it's important that we don't introduce new guidelines in PRs and end up with lots of widgets that are only compliant with some of those guidelines. A large codebase will over time benefit from the consistency.