Plugin Documentation Standards?

[mvlcek]

How about addint a html readme (along with installation guide, usage examples etc.) inside plugin archives ?

I'd rather have only a small text file in the plugin (what it does and how to install it), as it's easier to create and easier to read without unpacking the zip.

Thus I'd rather see the most important information in the support topic. There it's easy to update when a new problem/solution is found. As for examples (for frontend functionality), I suppose there is nothing better than to show it on a website.