Improve documentation on writing plugins

* link to the built-in plugins page instead of giving an incomplete list
  here
* syntax highlighting
Improve hooks documentation

* change the title : we don't *write* hooks, we use them to write hook
  handlers
* move the list of hooks at the top, as it will often be used as a
  reference
* merge paragraphs that were just one sentence long