Where communities thrive


  • Join over 1.5M+ people
  • Join over 100K+ communities
  • Free without limits
  • Create your own community
People
Activity
    jimman2003
    @jimman2003:matrix.org
    [m]
    :point_up: Edit: Yes of course @AnnaKatt you can be a librarian, bot development and much more..
    mbs1233
    @mbs1233
    hi i was looking for books in open library and i saw that many of them werent available and i have them on my e book how do i lend them or give them to someone who can put it there?
    Library Dude
    @librarydude33
    Hello, I had sent an email to volunteer as a librarian yesterday, yet I have not heard back. I was wondering how long the process takes. Thank you.
    Library Dude
    @librarydude33
    I find it rather amusing how you seem to always be begging for help from every common person out there with the site (Open Library) yet make it virtually impossible to do any meaningful changes or get permissions to do so. There is no automated verification obviously and no guidelines anyone can get to for seeing EXACTLY what one needs to do to be verified without actually being verified in the first place. Is this some inside joke and you actually want the open library project to fail. Is this being run by people who only proclaim to support Aaron Swartz's ideals yet do everything in their power to destroy those ideals, leading us on with misinformation and wasted time. I would suggest the VERY FIRST thing you need to do if you need more assistance is actually create a system that promotes that (one that's actually easily accessible and understandable). I had to actually traverse through a few sites to even get here. My apologies if I sound harsh, meandering through that wasteland you call a library for the past week while being virtually helpless to do anything about it has gotten on my nerves.
    Mek
    @mekarpeles

    Hi @librarydude33! Nice to meet you and thanks for the feedback. Your frustration is understandable and noted.

    Some other details; the entire Open Library team of staff has been 2 engineers (now 3) -- Drini, Jim, and myself. Volunteer team leads from the community step up to ensure the aspects of the service they care about also get done.

    In any given month, more than 20 volunteers may submit contributions and our staff invests in supporting, mentoring, and reviewing the changes of each of these contributors. This takes time.

    The library serves nearly 5M patrons; enabling around 350,000 borrows a month. We are the team responsible for maintaining the servers. For writing and deploying new code. For monitoring the pager when the service has performance issues. For working with librarians. For coordinating with policy teams. For drafting and executing on a roadmap for the project. For moderating spam and user-generated content. For supporting a group of volunteer librarians, more than 5 volunteer team leads, and 4 interns/fellows.

    Our entire roadmap is also public and the project is open source, meaning if there's something one is unsatisfied with, they have the power to change it, and our team does our best to support contributors in this pursuit with the time we have. Moreover, we host public community calls every Tuesday and developed our yearly roadmap with the inclusion and feedback of our entire community.

    Finally, the past 2 years we have added a variety of librarian features. An interface for merging duplicate works. A mechanism for deleting works and their editions in bulk. Bot infrastructure to clean up records en masse.

    Many processes such as adding and editing book records don't require librarian privileges. Some tasks like author merging and deleting records require privileges because these services require a certain level of trust and training -- otherwise, a mistake which takes 10 seconds to make, may cost our engineering team 30 minutes to untangle. Also, some contributors stick around for a few days and then disappear and training takes time, so we like to build rapport with teammates before granting permissions.

    Lisa, who is our lead community librarian, coordinates with more than 30 people in addition to her full time job. She typically is very fast at replying to passionate contributors who want to help out as Librarians. Even if one doesn't have librarian access, she and her teammates welcome requests for merging records.

    If you send me an email to mek@archive.org, I can work as quickly as possible to invite you to our librarian channel so at minimum, you may engage with other passionate librarians, raise your concerns, your wishes, and report records which need fixing.

    Thank you!

    Here is our 2021 planning document for any who may wish to review:
    https://docs.google.com/document/d/1U2zolE0q_H4ydO4ss4RvD9Tv-DJpNMs4T9k8Qxef20A/edit

    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
    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
    Benny Powers
    @bennypowers:matrix.org
    [m]
    nice
    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?
    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