Document extension metadata field.
This simple change adds a paragraph on how and why one would want to add the

metadata attribute to their extension class.

Generated HTML docs.