Skip to content
New issue

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

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

Already on GitHub? Sign in 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

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

No branches or pull requests

1 participant