# author:

Lists one or more authors for a source file.

  • Should typically just be a name

    # author: Susan Examplary
    
  • Or a comma-separated list of authors.

    # author: main man, contributor1, contributor2
    
  • URLs or email addresses are best listed behind author names instead:

    # author: Susan (http://example.org/), Miriam <miri@example.org>
    

Having separate author-url: and author-email: fields does not really help anywhere. Typically authorship is just shown once during plugin installation. And having a mini parser/renderer there is just less effort than maintaining two PMD fields.

(This is also advised because of Wordpress´ abhorrent "Author URI:" field → asking for an "URI:" but crapping out on urn:, data:, mailto: values.)