# description:

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.