fix/update/improve the documentation of long-running plugins

This fixes #25.