Often you want a more detailed description along with each plugin:
# description: Adds some feature in the extras section
Which can be sentence, but also shouldn't be too long.
Go for PEP8 and 60 characters max.
It might show up as tooltip in graphical UIs.
For more documatation-y explanations, use the doc comment below the PMD fields.