Add subsystem extensibility doc for reference

The shape of some of the APIs has been superseded since this was
originally written but the conceptual overview is still useful

Author: mhutch