docs: improved plugin docs.

closes #737.