New extension API updates (#176)

* first draft of new extension api docs

* Update docs/developers/components/reference.md

Co-authored-by: Chris Barber <[email protected]>

* fixes

* remove ready shortcut methods - reduce documented api scope

* remove incomplete sentance

---------

Co-authored-by: Chris Barber <[email protected]>

Author: Ethan-Arrowood