Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    Mek
    @mekarpeles

    Here is our active monthly sprint for any who wish to ask questions or weigh in on our active efforts:
    https://github.com/internetarchive/openlibrary/milestone/45

    Please note that responding to these requests also takes time, and while we're happy to engage, the total surface area of Open Library is ~100 contributors, many who week-to-week have questions, concerns, comments, and other needs. The Tuesday community calls 10a PT is a great opportunity to voice these comments; we explicitly dedicate half of the call to "Open Mic" where we may efficiently use our time to provide feedback or talk about specific issues relevant to our interests.

    Mek
    @mekarpeles
    @librarydude33 also, you're right, @aaronsw's ideals are my north star, but they're hard to live up to. When he left us I scrambled/floundered to step in to Open Library and even keep things afloat for almost 2 years as the only full time staff member. I have no illusions that I'm not doing as good a job as he would and wish he were here to guide the project :) though I assure you our team really is doing the best we can and are very open to feedback. I think we all want the same thing: openness and to preserve libraries as a resource that can improve our society. That starts with how we engage with and support each other. All I ask for is your patience so we can support you as well.
    And a huge thanks to @cdrini, @jimchamp, @seabelis, and many more who selflessly dedicate a significant part of their lives, taking pay cuts to work at a non-profit and investing long hours because they are committed to @aaronws's mission. There isn't a better team of people to work beside and I hope you have a chance to experience that :)
    Mek
    @mekarpeles
    @AnnaKatt we'd love your help improving accessibility! Thank you! If you'd like an invitation to our slack chat, we can find time to discuss the ideas you have and the problems you've been facing. Are there certain pages / buttons which aren't marked as clickable? Do you have more info you're willing to share about where and which book info may be repeated?

    @lakshya-dhariwal there are ~30 issues which we've identified as important one the community may be able to help with:
    https://github.com/internetarchive/openlibrary/issues?q=is%3Aopen+is%3Aissue+label%3A%22Needs%3A+Help%22

    Here are also 5 issues which are specific to the front-end:
    https://github.com/internetarchive/openlibrary/issues?q=is%3Aopen+is%3Aissue+label%3A%22Team%3A+Front-end%22

    And another 20 or so regarding website experience:
    https://github.com/internetarchive/openlibrary/issues?q=is%3Aopen+is%3Aissue+label%3A%22Affects%3A+Experience%22

    Michael Lustig
    @technoplato_twitter
    Hey guys-did a quick search through some docs but not seeing a way to query for book chapters. Am I missing something?
    Mek
    @mekarpeles

    @technoplato_twitter -- no great way to query book chapters. This data is often not asserted in our books (it used to be manually asserted by operators). Also, I don't believe chapter markers are indexed in the search engine.

    On Open Library, you can use the book API per book to query for the Table of Contents if it is available -- see: https://openlibrary.org/dev/docs/api/books

    Search for jscmd=details and/or table of contents

    Michael Lustig
    @technoplato_twitter
    Thanks for your response @mekarpeles
    Benny Powers
    @bennypowers:matrix.org
    [m]
    hello! Does the API have an OpenAPI schema, and if not, would you welcome a PR?
    jimman2003
    @jimman2003:matrix.org
    [m]
    I think the api doesn't have an OpenAPI schema so by all means open a PR. Note the api is active development though
    Mek
    @mekarpeles
    @bennypowers:matrix.org we'd probably want to have a conversation about the direction of our APIs prior to committing to a swagger spec. We've also considered graphql as a near-term offering. Our Tuesday community calls or a github "Question" type issue are likely the best avenues for this conversation :)
    Benny Powers
    @bennypowers:matrix.org
    [m]
    as it so happens i'm working on a graphql api
    but i think it would be good to base it off an open api schema and rest api
    Benny Powers
    @bennypowers:matrix.org
    [m]
    is there a POST endpoint, or do I have to use the web form at https://openlibrary.org/books/add? the online docs appear to be incomplete
    Benny Powers
    @bennypowers:matrix.org
    [m]
    and is there a way to add a custom title for a contributor e.g. Senior Content Editor or Executive Editor?
    Benny Powers
    @bennypowers:matrix.org
    [m]

    Hello friends. Did anything come of the GraphQL discussion? I have a little time available and I'm eager to start contributing. My neighbourhood is lacking a good English library and I want to write some software to make it easier for neighbours to open up their private bookshelves as lending libraries.

    My idea is to use openlibrary as the database, via ISBN ids, and to have some PWA web UI for scanning then registering the book as part of the private library, or POSTing book metadata to openlibrary in case it's missing.

    jimman2003
    @jimman2003:matrix.org
    [m]
    good idea
    but fyi there is https://github.com/gramps-graphql/data-source-openlibrary
    Benny Powers
    @bennypowers:matrix.org
    [m]
    So my thoughts are
    1. implement POST and PUT (if they're not implemented yet)
    2. implement OpenAPI v3 schema
    3. generate GraphQL server from schema
    4. work on UI
    5. profit!
    nice
    that looks perfect
    jimman2003
    @jimman2003:matrix.org
    [m]
    post is supported already
    Benny Powers
    @bennypowers:matrix.org
    [m]
    data-source is specific to apollo server. I had thought to use https://www.graphql-mesh.com/, but if the data source is under active development, all the better
    jimman2003
    @jimman2003:matrix.org
    [m]
    that repo is old though :(
    Benny Powers
    @bennypowers:matrix.org
    [m]
    I see
    well it might be worth investing in OpenAPI schema then
    because then we get graphql for free via graphql-mesh
    which can consume and open api schema and output graphql resolvers, that we can then plug in to any graphql server e.g. apollo-server
    we could also geneerate docs site from openapi. I think the current docs are out of date? (no post docs)
    jimman2003
    @jimman2003:matrix.org
    [m]
    you can read https://github.com/internetarchive/openlibrary-client as a short term solution
    Benny Powers
    @bennypowers:matrix.org
    [m]
    does that just implement the REST apis?
    jimman2003
    @jimman2003:matrix.org
    [m]
    yes
    Benny Powers
    @bennypowers:matrix.org
    [m]
    ok cool. I saw that but skipped over it since I'm developing in node
    jimman2003
    @jimman2003:matrix.org
    [m]
    e.g see https://github.com/internetarchive/openlibrary-client/blob/a655402b1f33dee47670c21171139bebc4c06cde/olclient/openlibrary.py#L121
    Benny Powers
    @bennypowers:matrix.org
    [m]
    nice
    jimman2003
    @jimman2003:matrix.org
    [m]
    or https://github.com/internetarchive/openlibrary-client/blob/a655402b1f33dee47670c21171139bebc4c06cde/olclient/openlibrary.py#L265
    beware : the api might change as said by @mekarpeles
    Benny Powers
    @bennypowers:matrix.org
    [m]
    yeah so that's why I'm keen to help write the OpenAPI schema first
    until then I can work on my UI a little
    Benny Powers
    @bennypowers:matrix.org
    [m]
    can I read the code to to the actual API endpoints?
    jimman2003
    @jimman2003:matrix.org
    [m]
    https://github.com/internetarchive/openlibrary-client/blob/a655402b1f33dee47670c21171139bebc4c06cde/olclient/openlibrary.py#L133
    Benny Powers
    @bennypowers:matrix.org
    [m]
    nice
    oh i meant the server code that receives the requests
    jimman2003
    @jimman2003:matrix.org
    [m]
    I am a relative new contributor.. let me search that
    Benny Powers
    @bennypowers:matrix.org
    [m]
    ty
    jimman2003
    @jimman2003:matrix.org
    [m]
    in this repo https://github.com/internetarchive/openlibrary
    jimman2003
    @jimman2003:matrix.org
    [m]
    in this I think https://github.com/internetarchive/openlibrary/blob/master/openlibrary/plugins/books/code.py
    Benny Powers
    @bennypowers:matrix.org
    [m]
    wonderful
    I opened internetarchive/openlibrary#5590 to track discussion on openapi/graphql
    sadn1ck.
    @sadn1ck:matrix.org
    [m]
    hello 👋