Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

How should a document with multiple authors be presented? #686

Open
benlk opened this issue Feb 13, 2023 · 1 comment
Open

How should a document with multiple authors be presented? #686

benlk opened this issue Feb 13, 2023 · 1 comment

Comments

@benlk
Copy link

benlk commented Feb 13, 2023

Many documents on the web are a product of joint authorship. How should they be presented?

The most-backwards-compatible way is to put the author names all in the author_name field, and then pick one author's URL for display:

{
  "version": "1.0",
  "provider_name": "largo.test",
  "provider_url": "https://largo.test",
  "author_name": "Alice Example and Bob Example",
  "author_url": "https://largo.test/author/alice-example/",
  "title": "This is a post by two authors",
  "type": "rich",

But that loses the link for Bob Example.

Could this spec be updated to support multiple authors, with a fallback for parsers that have not been updated?

{
  "version": "1.0",
  "provider_name": "largo.test",
  "provider_url": "https://largo.test",
  "authors": [
    {
      "author_name": "Alice Example",
      "author_url": "https://largo.test/author/alice-example/",
    },
    {
      "author_name": "Bob Example",
      "author_url": "https://largo.test/author/bob-example/",
    }
  ],
  "author_name": "Alice Example and Bob Example",
  "author_url": "https://largo.test/author/alice-example/",
  "title": "This is a post by two authors",
  "type": "rich",
@benlk
Copy link
Author

benlk commented Mar 21, 2023

Considerations for supporting multiple authors:

  • backwards-compatiblity:
    • What recommendation should the specification make for choosing the URL that goes in author_url?
    • What recommendation should the specification make for presenting multiple authors in author_name?
  • internationalization/localization: An array of authors would leave it up to useragents to determine the presentation order and conjunctions used when formatting the array for output

# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant