Openlibrary: Schema.org tags for authors

Created on 21 Mar 2020  ·  17Comments  ·  Source: internetarchive/openlibrary


When we search for books by \ https://www.google.com/search?q=books+by+mark+twain+openlibrary&oq=books+by+mark+twain+openlibrary we are shown a search result as shown below but the author does not have schema markup so my proposal is to add person schema.org tag to the author.

Opportunity: It could have search engine consequences for 8 million of our author pages.

@tfmorris:
As @seabelis pointed out on Slack, not all authors are people, but we can probably safely tag anyone with a birth or death date. In addition to Person.birthDate and Person.deathDate, other markup which could be added includes Thing.alternateName for each of the AKAs, Thing.sameAs to link to Wikidata.

The works on the page are already tagged as schema.org Books, but they could additionally be decorated with CreativeWork.author, CreativeWork.about (ie subjects), CreativeWork.publication, CreativeWork.inLanguage, etc.

Screenshot from 2020-03-21 11-14-43

Stakeholders


@tabshaikh

Good First Issue @tabshaikh Help 2 Distribution SEO Feature Request hacktoberfest

Most helpful comment

@BrittanyBunk are you referring to clutter in terms of UI changes it will bring to the search results?

All 17 comments

As @seabelis pointed out on Slack, not all authors are people, but we can probably safely tag anyone with a birth or death date. In addition to Person.birthDate and Person.deathDate, other markup which could be added includes Thing.alternateName for each of the AKAs, Thing.sameAs to link to Wikidata.

The works on the page are already tagged as schema.org Books, but they could additionally be decorated with CreativeWork.author, CreativeWork.about (ie subjects), CreativeWork.publication, CreativeWork.inLanguage, etc.

I do understand that people do like to add schema with SEO - but I feel sometimes it creates clutter. To me - it's just too much to read. It already has the novel in the description and people will click the link to see the rest. I don't see a need to add it to the search results (a place where it needs to be quick reading/action to get to where one needs to be).

Clutter? All schema.org markup is invisible.

@BrittanyBunk are you referring to clutter in terms of UI changes it will bring to the search results?

@BrittanyBunk please make sure you really understand the issue before weighing in and providing feedback. In this case, the schema tags only appear in the underlying markup and are not visible ot users (other than how google decides to augment their experience).

Feel free to ask a clarifying question.

@tabshaikh yes! It just is showing too much of what's already there. I think one book's ok, but it shouldn't say 'books by _author". That line is also inessential, as we already know the author on the title of the link.

@mekarpeles I've seen schema used on a back-end before (I think?), and it's a lot and some of it doesn't get used, but is there just in case - so even if it's cluttering on the back-end, it's needed there for potential use - even if it's not in use at the moment.

@BrittanyBunk schema.org tags are not displayed visibly on a web page to the end-user. They are specifically used to provide context and semantics to search engines.

Please take a look at this video: https://www.youtube.com/watch?v=9HvMv_1zG2s

An important way that Google knows one of our pages is about a "book" or about an "author" is if we tell Google. And this is done by adding specific html tags to our markup.

If your concern is specifically about how Google renders its results, Google is only one search engine of many out there which use schema tags to the benefit of their users and I'm confident Google done its market and user research and designed their interfaces accordingly. We're in a position of trusting search engines to provide the right value to their users. We should surface the right data from Open Library to all search engines. If you'd like Google to do something different about their results, that is out of scope of this issue.

Let's please move forward with this issue. It's a very easy metadata fix and it could have search engine consequences for 8 million of our author pages.

Thanks @mekarpeles @tfmorris for the feedback, updated the issue accordingly :)

Hello There! can I be assigned this task?

@devarshigoswami sure you can go ahead if you need any help you can ping me :)

@tabshaikh I understand Openlibrary is using microdata schema. Do I need to add it specifically to Mark Twain's' author page or in templates in general?
Also, do you guys use google tagmanger for updating schema? Because that approach looks really simple and I believe newbie contributors would easily be able to contribute to SEO.

@tabshaikh , please respond..

Do I need to add it specifically to Mark Twain's' author page or in templates in general?
Templates in general.

templates in general I would say @devarshigoswami

@tabshaikh, I would like to work on this, can you please tell me, Is openlibrary/macros/SearchResultsWork.html this the file where we need to add the Person schema

https://github.com/internetarchive/openlibrary/blob/1e31269adcc7118642e591e9dcfc04f400bdf658/openlibrary/macros/SearchResultsWork.html#L40
If it is the file that needs the work then, Can you please confirm If am moving in the right direction, is this the line where we need to add Person.birthDate, Person.deathDate, and other schema mentioned in the issue description? I was a bit confused, so thought to ask. Thank you

Hi @nk4456542 :wave: Schema should be added in this file https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/type/author/view.html
The schema tags mentioned in this message would suffice https://github.com/internetarchive/openlibrary/issues/3231#issuecomment-602078002 You could also propose additional schemas which are relevant to our content and you could use this site as your reference https://schema.org/author

Thank you @tabshaikh. Will start working on this

Was this page helpful?
0 / 5 - 0 ratings

Related issues

nonom picture nonom  ·  3Comments

cdrini picture cdrini  ·  5Comments

BrittanyBunk picture BrittanyBunk  ·  5Comments

BrittanyBunk picture BrittanyBunk  ·  4Comments

cdrini picture cdrini  ·  4Comments