Docs audit - plugin.php.

I'll start collecting commits here for the promised docs audit.