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

Need for evaluation date metadata #1590

Closed
mattgarrish opened this issue Mar 26, 2021 · 10 comments
Closed

Need for evaluation date metadata #1590

mattgarrish opened this issue Mar 26, 2021 · 10 comments
Labels
Accessibility11 Issues addressed in the Accessibility 1.1 revision Cat-Accessibility Grouping label for all accessibility related issues Spec-Accessibility The issue affects the EPUB Accessibility 1.1 Recommendation Topic-Accessibility-Vocab The issue affects the EPUB Accessibility vocabulary

Comments

@mattgarrish
Copy link
Member

mattgarrish commented Mar 26, 2021

Opening this issue since we touched on this in yesterday's telecon.

While this is important for the web, I'm not sure it's necessary for an epub publication. What would be the difference between the evaluation date and the last modified date?

Even if you republish without doing a re-evaluation, you can infer a renewal of the initial evaluation otherwise the certification should be removed. I expect users will do this, as it will be confusing understand why the dates might differ (e.g., does it mean it wasn't rechecked or that it continues to be valid to an old evaluation).

The only cases I can think of for an evaluation date would be: 1) a legacy record of when the publication was first evaluated (but this overlaps with revision histories which we don't address); and 2) if there were multiple evaluations and some aren't rechecked. Neither of these seems compelling enough to add the additional complexity of separate evaluation dates. But that's just my opinion...

@mattgarrish mattgarrish added Cat-Accessibility Grouping label for all accessibility related issues Spec-Accessibility The issue affects the EPUB Accessibility 1.1 Recommendation Topic-Accessibility-Vocab The issue affects the EPUB Accessibility vocabulary labels Mar 26, 2021
@OriIdan
Copy link

OriIdan commented Mar 26, 2021 via email

@gregoriopellegrino
Copy link
Contributor

From a third party certifier point of view I think it is useful to have the certification date, in particular if the EPUB creator changed the file without telling to the certifier.

This is to identify the right responsibilities in case of non-compliant content.

@mattgarrish
Copy link
Member Author

This is to identify the right responsibilities in case of non-compliant content.

In a case like this, wouldn't you want to have an internal record that couldn't be tampered with by the publisher? A publisher might just update your date assuming everything is still good.

@mattgarrish
Copy link
Member Author

Can this be addressed with existing metadata? For example:

<link rel="a11y:certifierReport" id="cert" href="http://example.com/report/abc">
<meta property="dcterms:issued" refines="#cert">2021-01-01</meta>

Since this metadata is evaluator-specific, it's always going to be weird if there isn't a report to link the date to. You'll have to do something like:

<meta property="a11y:certifiedBy" id="cert">Me</meta>
<meta property="dcterms:issued" refines="#cert">2021-01-01</meta>

But at least this way we don't propagate more date fields.

@gregoriopellegrino
Copy link
Contributor

Fine for me!

@mattgarrish mattgarrish added the Status-ProposeClosing The issue is no longer relevant, or has already been fixed, and should be closed. label May 5, 2021
@mattgarrish
Copy link
Member Author

Let's close this issue off, then. If we find that the existing metadata isn't sufficient, at least we'll have a stronger basis for returning to this issue and figuring out what can be improved.

@mattgarrish mattgarrish added Accessibility11 Issues addressed in the Accessibility 1.1 revision and removed Status-ProposeClosing The issue is no longer relevant, or has already been fixed, and should be closed. labels May 11, 2021
@iherman
Copy link
Member

iherman commented Sep 10, 2021

The issue was discussed in a meeting on 2021-09-09

  • no resolutions were taken
View the transcript

3. Need for evaluation date metadata (pr epub-specs#1590)

See github pull request #1590.

Avneesh Singh: okay, so let's do that
… this one is about potentially having a certification date

Matt Garrish: if you want to put a date in your can use a dc:terms value, and to attach that to the certifier
… its not something we're defining, or that we require, but the question keeps coming up
… so this just adds an example to the spec

Avneesh Singh: any objections?

Charles LaPierre: and so you would use refines to point to the certifier?

Matt Garrish: yes

@gregoriopellegrino
Copy link
Contributor

I am reopening this issue just for clarification. Here @mattgarrish suggests using dcterms:issued, while in the EXAMPLE 6 example there is dcterms:date.

Which of the two to use? Perhaps semantically dcterms:issued is better, but I don't have a strong opinion on that.

@mattgarrish
Copy link
Member Author

Perhaps semantically dcterms:issued is better

I think I mentioned on a call that even though I proposed it here, it doesn't really work for a conformance statement. The definition is:

Date of formal issuance of the resource.

If we were dating the issuing of a certifier report, I'd agree this property is more appropriate. We don't issue the "conforms to" claim in the metadata; there's just a date when it was evaluated. That's what this field is modifying, as there isn't always a report that goes along with the claim.

That's why I suggested we should only use a regular date property.

@gregoriopellegrino
Copy link
Contributor

Got it, thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Accessibility11 Issues addressed in the Accessibility 1.1 revision Cat-Accessibility Grouping label for all accessibility related issues Spec-Accessibility The issue affects the EPUB Accessibility 1.1 Recommendation Topic-Accessibility-Vocab The issue affects the EPUB Accessibility vocabulary
Projects
None yet
Development

No branches or pull requests

4 participants