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

Add LearnAwesome.org to ID Numbers list #3382

Closed
teampolyglot opened this issue Apr 20, 2020 · 8 comments · Fixed by #3383
Closed

Add LearnAwesome.org to ID Numbers list #3382

teampolyglot opened this issue Apr 20, 2020 · 8 comments · Fixed by #3383
Labels
Lead: @cdrini Issues overseen by Drini (Staff: Team Lead & Solr, Library Explorer, i18n) [managed] Priority: 4 An issue, but should be worked on when no other pressing work can be done. [managed] Type: Feature Request Issue describes a feature or enhancement we'd like to implement. [managed]

Comments

@teampolyglot
Copy link

teampolyglot commented Apr 20, 2020

I work on https://learnawesome.org which is an open-source repository of learning resources. For books, it links out to the corresponding OpenLibrary page. But LearnAwesome.org also maintains links to related multimedia content (author's podcasts, TED talks, summaries written by others). See https://learnawesome.org/items/5c731d15-6a53-432e-82e4-a4de9fecb2d1-the-first-20-hours for example.

Describe the problem that you'd like solved

It will be very useful to have a link from OpenLibrary pages to the corresponding item on LearnAwesome.org

Proposal & Constraints

This block should be added to openlibrary/plugins/openlibrary/pages/config_edition.page:

        {
            "url": "https://learnawesome.org/items/@@@",
            "website": "https://learnawesome.org",
            "name": "learnawesome",
            "label": "LearnAwesome.org"
        }

FYI: LearnAwesome doesn't have separate pages for editions so the ID is mostly an identifier of the Work. Also, their canonical URL has a human-readable slug which is optional. For eg. both https://learnawesome.org/items/c7cc421f-608d-4d92-bf9d-b73d78b8ae2a-how-to-win-friends-and-influence-people-1936 and https://learnawesome.org/items/c7cc421f-608d-4d92-bf9d-b73d78b8ae2a return the same page but canonical URL is the first one. Like GoodReads, we will link to the latter.

Additional context

On https://openlibrary.org/books/OL1186728M/How_to_Win_Friends_and_Influence_People , this is how it would appear:
image

With the link being as: https://learnawesome.org/items/c7cc421f-608d-4d92-bf9d-b73d78b8ae2a

Stakeholders

Not sure. I had a chat with @tabshaikh about it though.

@teampolyglot teampolyglot added Needs: Triage This issue needs triage. The team needs to decide who should own it, what to do, by when. [managed] Type: Feature Request Issue describes a feature or enhancement we'd like to implement. [managed] labels Apr 20, 2020
@tabshaikh
Copy link
Collaborator

tabshaikh commented Apr 20, 2020

tagging @mekarpeles and @seabelis for triage :)

@mekarpeles mekarpeles added Lead: @cdrini Issues overseen by Drini (Staff: Team Lead & Solr, Library Explorer, i18n) [managed] Priority: 4 An issue, but should be worked on when no other pressing work can be done. [managed] and removed Needs: Lead Needs: Triage This issue needs triage. The team needs to decide who should own it, what to do, by when. [managed] labels Apr 20, 2020
@BrittanyBunk
Copy link
Contributor

BrittanyBunk commented Apr 21, 2020

I'm looking at this - I'm not the decision-maker here, but what benefit would adding this website be to the OL? I looked at your website and didn't see much on it, so I'm asking for more info on that.

The reason why is because if there isn't a strong enough reason to add it in, then adding it will cause problems. 1) too much clutter, 2) will feel like an advertisement, 3) too much space in the data dump, which is already pretty large as-is. I mean, Barnes and Noble wasn't added in and you could read about it here: #2395. So this is going to prepare you to show what you're up against, so you know how to address the potential conflicts this has with the site.

@seabelis
Copy link
Collaborator

@eshnil Since the corresponding pages are not edition-specific, it would be appropriate to link from work-level links rather than the editions. Otherwise you'd have to add the links to each edition rather than one time to the work.

@teampolyglot
Copy link
Author

teampolyglot commented Apr 21, 2020

@seabelis Completely agree. Could you please guide me on what change I should make in my PR for this?

@BrittanyBunk I was motivated by GoodReads being supported here which is a non-FOSS, for-profit sites and feels much more like an advertisement and seems directly in conflict with OpenLibrary unlike LearnAwesome which is open-source and has a different goal. I am in fact perplexed by your comment on the Barnes and Nobles issue which says GoodReads is not on the list because it actually is! Other commercial sites present in the list are Amazon (multiple local sites), AbeBooks.de, Alibris.com, Bookwire.com, Bookmooch.com, BookLocker.com, ChooseBooks.com among others.

To clarify, LearnAwesome doesn't intend to be a direct equivalent of GoodReads or OpenLibrary at all. The project is about creating a universal learning map. It doesn't host or sell any content and just maintains links with rich metadata to generate optimal, personalized learning pathways. The benefit for users is to USE books for their learning projects which is also why the site provides links to alternative formats like summaries, author's talks/interviews as alternatives to the book itself. It doesn't list prices or purchase links at all. Put simply, LearnAwesome is an open-source catalogue of educational works in multiple formats, and actually delegates/redirects traffic to sites like OpenLibrary. I just created this issue to reinforce this.

Concern about clutter and data bloat seem valid. Using the same criteria, would you recommend removing all these commercial vendors (including GoodReads and multiple Amazon sites) from this list?

It seems the purpose of the identifiers list is not clear. Barnes and Nobles was rejected because it supports ISBN search, but at the same time multiple commercial, non-FOSS sites like Amazon/GoodReads/Bookwire are accepted which also do support ISBN search. The former implies that this list is not intended to show mere links to purchase, but then I don't understand why Amazon or Bookwire etc are allowed.

@teampolyglot
Copy link
Author

teampolyglot commented Apr 21, 2020

I realized I didn't directly address your question :-)

what benefit would adding this website be to the OL

It can help OL users in using a given book effectively in their learning projects. For eg, the users can discover related works - which are not just books - such as author's TED Talk, links to summaries and critiques of this book by other experts, create a personalized learning path and find a community of learners interested in the same topic. OL can also use this identifier to fetch data (such as related works, connections to other topics in the ConceptNet) if needed. Being open-source, all of learnawesome.org's data is available via an open api.

@BrittanyBunk
Copy link
Contributor

BrittanyBunk commented Apr 22, 2020

What you're saying really truly makes sense. If there's a place to say 'LearnAwesome.org' is a non-commercial, multi-media, educational open-source catalog for a person's learning ventures (or projects, any wording you choose is fine).

So what you were saying about the conflicts of commercial sites on the OL does make sense - and I thought of a new issue/solution because of it: because there are commercial sites on here - designating your site somehow (with an asterisk, a separation), etc. as different from the commercial sites to prevent people from having the wrong impression (like I had). It's just a suggestion.

I think your site is great, because everyone has different learning styles and also can only go so far in learning something from a book before they run out of info and context. Like your site having followup videos makes books more interactive, engaging, and in-depth - that's something I look for when I learn personally to help me understand concepts better! Cool!

A personal side-note anecdote - some teachers in my schools didn't want me to look only at a work and not look at the background and context and everything - I didn't learn much from those classes. It's only the ones that let me find and had multi-media where I got to learn and do better than most of the class even - so way to go :)

Open source - even better :)

@seabelis
Copy link
Collaborator

@eshnil @cdrini is assigned (and far better qualified than I) to review your PR. What I will note is that the links at work-level are not based on identifiers, so there wouldn't be a modification needed to the input form. To add the links programatically would require a script/bot (@cdrini correct me if I'm wrong). You would already be able to add them manually via the edit form.

@cdrini
Copy link
Collaborator

cdrini commented May 1, 2020

Yeah, this should live on the work, but we currently don't support IDs on the work (created issue #3430 ). I think I'm ok adding this in as is though; we already have links on editions that should be on works (e.g. LibraryThing). We can migrate them over once the option exists.

The reason Barnes & Nobles was rejected as an identifier was because it seemed like they only supported ISBN. Amazon/Better World Books/etc also have identifiers for non-ISBN books (which are useful). The purpose of the identifiers section is to link data :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Lead: @cdrini Issues overseen by Drini (Staff: Team Lead & Solr, Library Explorer, i18n) [managed] Priority: 4 An issue, but should be worked on when no other pressing work can be done. [managed] Type: Feature Request Issue describes a feature or enhancement we'd like to implement. [managed]
Projects
None yet
Development

Successfully merging a pull request may close this issue.

6 participants