Overview

Artifact ID: 9e492680a5d040b438dda99a8a5fa18493c9ab4376ec76190772c9e5adf12d11
Page Name:author
Date: 2018-07-05 14:35:16
Original User: mario
Mimetype:text/x-markdown
Parent: 356e8d7ea4650fe9095400bfdbd57d41fb7c903431ce247d07c0201a45cfe349 (diff)
Content

# 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.)