Openlibrary: Create a UI to match the proposed EDTF

Created on 3 Apr 2020  路  8Comments  路  Source: internetarchive/openlibrary

Note; there was some confusion in both #2039 and #3301, so this is clarification. This also is going to be different that what will be shown in the OL UI (UI = user interface, or what users see on teh webpages).

Problem:

Right now, I don't believe people follow the proposed EDTF mentioned in #2039 when writing in the date. This causes issues in the data dump where the formatting is inconsistent (this is just one section of the data dump):
image.

Solution:

create a UI for the edit page to make it easier to follow the EDTF format that includes instructions (see the table in #2039):
image

Notes:

  • this format would be great to add to the 'add book' page to match the 'edit' page.
  • the format will account for what's unknown. So if for instance, the exact year is known, one could add X's to it
    'BCE' adds a '-'
    'Approx.' adds a '?'

Stakeholders

Anyone from both #2039 and #3301 and those who look at the data dump and those who would like to see the EDTF format be used.

UI @mekarpeles 3 Feature Request

Most helpful comment

I think user input should be restricted to just date, not datetime. If we're trying to make the date easier to comply with EDTF, we should eliminate free form text entry.

Edit: typos

All 8 comments

EDTF is an internal date format, not something for users.

@tfmorris What someone inputs gets converted to the EDTF from what I see - like the table Drini created in #2039. People will enter in values - that's column 2. What it gets converted to, the EDTF, is column 3.

I think user input should be restricted to just date, not datetime. If we're trying to make the date easier to comply with EDTF, we should eliminate free form text entry.

Edit: typos

@guyjeangilles I don't think time should be required either. How about:
image

  • 'BCE' adds a '-'
  • 'Approx.' adds a '?'

As per discussion with @seabelis, here's an adjustment to the proposed layout:
image

@seabelis your thoughts?

The overwhelming majority of editions have just a year or year and month. This seems to overcomplicate matters. If there has to be an input form like this, then maybe it's possible to show just the year and month fields (maybe day) with an option to extend to an 'advanced' form with the date range and BCE.

I'd really prefer to just put additional instructions on the form asking folks to use the yyyy-mm-dd format and to click for more info about advanced options.

This follows the EDTF format, which it's why it's this way. You're referring to the last image I posted right? A year range I feel is relevant, but it's up to you on that.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

BrittanyBunk picture BrittanyBunk  路  4Comments

skylerbunny picture skylerbunny  路  4Comments

BrittanyBunk picture BrittanyBunk  路  5Comments

cdrini picture cdrini  路  4Comments

BrittanyBunk picture BrittanyBunk  路  4Comments