fixed the plugin stuff in the top level README and added a new README

in the plugins directory.

This explains the current behavior in a fair bit of detail. Hopefully this and the hello_world
exemplar together provide enough information for intrepid developers.

Some of the stuff documented will likely change soon, but I wanted to get it down now,
before I forget.