Clarify extension API

Added detail about use of `type` attribute