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.

Testing done: Generated HTML docs.
Reviewed at https://reviews.reviewboard.org/r/4794/