Improve layout of the "edit This Edition" page

onnotasler commented 1 year ago

I am constantly searching for the fields "Is it known by any other titles?", "Any notes about this specific edition?" and "What work is this an edition of?" field on the "edit This Edition" page. It would be great if the fields could be more easily distinguished.

Also, the page seems tediously long to scroll, this is elevated by the fact that the middle part is less often used then the top (basic information) and bottom part (page numbers, kind of book).

Describe the problem that you'd like solved

Order the possible entry fields on the Edit Edition pages that makes it easier to find these smaller entry fields, which are somewhat overwhelmed by the bigger fields in front of them.

Putting often used fields closer to each other, and less often used fields farther away.

Proposal & Constraints

Analyse librarians workflow on the edit page and design an edit book page that conforms more closely to how librarians use it.

Additional context

Screenshot 2022-12-21 at 17-01-56 Finnegans wake Open Library

https://github.com/internetarchive/openlibrary/issues/7261 (This is a part of Improve OpenLibrary's User Interface to make librarians work easier)

Stakeholders

Probably Samuel and Dana.

WilsonGoins commented 7 months ago

@mekarpeles I think I can help with this issue. What order specifically should the elements on this page go in?

mekarpeles commented 7 months ago

Hi @WilsonGoins! I'd love to invite you to our Open Library slack channel where we can ask librarians what order they prefer!

If you'd like to share your email address with me, I'm mek@archive.org and will be happy to connect y'all!

In the meantime @onnotasler -- can you provide a few concrete examples as a checklist of what items you're confident we want changed?

onnotasler commented 7 months ago

I think I can help with this issue. What order specifically should the elements on this page go in?

There are two priorities: How often do Librarians edit those fields, and how important are the fields for OpenLibrary functions.

In the meantime @onnotasler -- can you provide a few concrete examples as a checklist of what items you're confident we want changed?

For example:

Description of this edition is rarely used, because most editions use the same description as the work.
Any notes about this specific edition? is hardly ever used as well, as very few books need it.
The info in The Physical Object on the other hand is shown prominently on the edition page and required for almost any book.
The Language fields are absolutely crucial for many functions of OpenLibrary, but set aside on the margins.

mekarpeles commented 7 months ago

Thank you @onnotasler! Those are 4 good actionable to start with :)

WilsonGoins commented 7 months ago

@mekarpeles I sent an email to mek@archive.org with my email so you can invite me to the slack. I am having trouble finding the html file that would be responsible for this page. Is it “openlibrary/templates/book/edit.html” or a different file? Thanks!

mekarpeles commented 7 months ago

Hi @WilsonGoins I wasn't able to find your email, but I did find contact info in your git log for your chess repo and sent you an invite. :)

This file has the UI for the Book/Edition/Work page: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/type/edition/view.html

The edit UI for the book page is: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/books/edit/edition.html

WilsonGoins commented 7 months ago

Awesome thank you so much!

Get Outlook for iOShttps://aka.ms/o0ukef

From: Mek @.> Sent: Wednesday, January 31, 2024 12:11:36 PM To: internetarchive/openlibrary @.> Cc: Goins, Wilson F. @.>; Mention @.> Subject: Re: [internetarchive/openlibrary] Improve layout of the "edit This Edition" page (Issue #7314)

[External Email]

Hi @WilsonGoinshttps://github.com/WilsonGoins I wasn't able to find your email, but I did find contact info in your git log for your chess repo and sent you an invite. :)

This file has the UI for the Book/Edition/Work page: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/type/edition/view.html

The edit UI for the book page is: https://github.com/internetarchive/openlibrary/blob/master/openlibrary/templates/books/edit/edition.html

— Reply to this email directly, view it on GitHubhttps://github.com/internetarchive/openlibrary/issues/7314#issuecomment-1919545495, or unsubscribehttps://github.com/notifications/unsubscribe-auth/A32GUBPHHGDCUYWJ32TUF6LYRJ3MRAVCNFSM6AAAAAATFZBHR6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTSMJZGU2DKNBZGU. You are receiving this because you were mentioned.Message ID: @.***>

WilsonGoins commented 7 months ago

Hey Mek, I am trying to set up the environment to run OpenLibrary locally and I am having some trouble. I did well installing Docker and I cloned the repo using an SSH key and tried to trouble shoot as best I could with the ReadMe in the Docker directory.

I keep getting stuck at the "No module named infogami" error. I have done the full reset of my environment, followed the "fix line endings, symlinks, and git submodules" help page, but I can't get rid of the error. I would love some help in getting the local site running on my computer so I can visualize the front end changes I will be making.

Thanks!

Wilson Goins

scottbarnes commented 7 months ago

@WilsonGoins, I replied to you on Slack to see if I can help out.

mekarpeles commented 7 months ago

As a next step, @scottbarnes will ask in our librarian channel on slack to offer feedback on these changes and see which ones we're able to move forward with. Thank you so much for your help!

internetarchive / openlibrary