Take a look at how popular application actually document, /explain to users how they could possibly extend their application.
Hints:Popular applications sample:
- apache modules
- eclipse/intellij plugins
- firefox/chrome extensions
(- emacs modes)
...