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

Add <rightsdeclaration> to <control> #506

Closed
rockivist opened this issue Dec 9, 2016 · 18 comments
Closed

Add <rightsdeclaration> to <control> #506

rockivist opened this issue Dec 9, 2016 · 18 comments

Comments

@rockivist
Copy link
Member

I propose adding a new element to EAD3 for recording the rights associated with the description itself. A common use case would be to declare that the description is shared under a CC0 license.

I suggest naming the element <rightsdeclaration>, following the name pattern of conventiondeclaration, languagedeclaration, and localtypedeclaration. I would pattern the content model after <conventiondeclaration>, which includes a required <citation> element, and optional <abbr> and <descriptivenote> elements. One important difference would be including the @localtype attribute on the <rightsdeclaration> element so that it can be subclassed as necessary.

Here is an example of a possible <rightsdeclaration> element:

<rightsdeclaration localtype=”license”> <abbr>CC0</abbr> <citation href=”https://creativecommons.org/publicdomain/zero/1.0/”> CC0 1.0 Universal (CC0 1.0) </citation> </rightsdeclaration>

I would make <rightsdeclaration> an optional, repeatable child of <control>, available as a following sibling of conventiondeclaration and a preceding sibling of localtypedeclaration.

@ruthtillman
Copy link

Like it overall. One question: what does it look like for those who want to put an "All rights reserved" in the rights declaration?

Although RightsStatements seem to be more appropriate for materials as CC is more appropriate for finding aids, I suppose it could be http://rightsstatements.org/vocab/InC/1.0/ with text "All rights reserved" ... Or are we going to say "if you want it in copyright have your own URL to your copyright statement"?

@rockivist
Copy link
Member Author

@ruthtillman you've identified the major weakness as I see it. I think it's OK for <rightsdeclaration> to prioritize linking out to separate rights statements. If someone wants to simply put a copyright statement not linked to a formal rights statement, they can still put a paragraph in <publicationstmt>. I think we're trying to focus on something actionable with the new element, and there isn't much you can do with a simple text string in that regard. Happy to hear conflicting opinions, of course.

@ruthtillman
Copy link

@rockivist I like the idea of adding that to guidance about using the new element. aka "<publicationstmt> still exists if all you want to do is note that you retain copyright, whereas this is for actionable link-based statements, whether yours or mainstream. Please use mainstream." -- but nicer.

@SJagodzinski
Copy link

SJagodzinski commented Jan 10, 2017

I'm in favour of the solution forwarded by Wim (//rightsdeclaration/rightsinfo) because we do know about the semantic of the elements content and we don't need to use a general descriptive or referring element for that. In my opinion it would be more distinct and neat for this purpose. I'd also allow content in //rightsinfo, so there is no need for //p, but I'm not familiar with the EAD politics here.

example:
example:
<rightsdeclaration> <rightsinfo type=”license” identifier=”https://creativecommons.org/publicdomain/zero/1.0”>CC0</rightsinfo > <rightsinfo type=”copyright”>© 1998 Regents University of California</rightsinfo> </rightsdeclaration>

rockivist added a commit that referenced this issue Feb 4, 2017
Added rightsdeclaration as per #506 as a zeroOrOne child of control,
immediate following sibling of convention declaration.
rockivist added a commit that referenced this issue Feb 4, 2017
Added rightsdeclaration as a zeroOrMore child of control, immediate
following sibling of conventiondeclaration. Content model is the same as
conventiondeclaration except for the addition of localtype.
@rockivist
Copy link
Member Author

Implemented in branch issue_506. Wait to merge for final approval.

@tcatapano
Copy link
Member

Looks like we need to compile this and #485, #506, and #507 into the various derived RNG, DTD, and XSD files for testing before merging. Is that right? If so, I'll create an issue and assign to myself.

@rockivist
Copy link
Member Author

@tcatapano yes, that would be very helpful.

@tcatapano
Copy link
Member

OK. I'll make an issue. See #509

@rockivist
Copy link
Member Author

@cannedit @SJagodzinski @noahgh221 @BillStockting2 Following up on this issue, here are my arguments in favor of implementing rightsdeclaration as I described it above rather than as a rightsdeclaration with one or more rightsinfo elements.

-The pattern set in EAC-CPF and perpetuated in EAD3 within control is not to bundle the "declaration" elements (languagedeclaration, conventiondeclaration, localtypedeclaration) into wrapper elements. Having rightsdeclaration include one or more rightsinfo elements would change this convention. The revision process taught me to value consistent conventions highly, hence my preference.

-I also prefer the predictability that comes from two elements (conventiondeclaration and the proposed rightsdeclaration) sharing data models. They are conceptually similar, referencing external docments/resources in an actionable. way. It's easier to teach and to develop systems when they are structured similarly.

-I see the proposed rightsdeclaratoin/citation and rightsdeclaration/rightsinfo as essentially equivalent, so comparing the two proposed data models comes down to the additional presence of abbr and descriptivenote. Regarding descriptivenote,, we have included it in nearly all of the "declaratoin" elements in EAC and EAD3. Omitting it would again change a consistently followed convention. Omitting abbr would be less of a contradiction of convention, but I do think it is helpful to separate out an abbreviation used to refer to something from the citation for the thing itself.

What do all of you think? What do you think? If possible, please comment by the end of this week (Friday, 17 February).

@BillStockting2
Copy link

BillStockting2 commented Feb 13, 2017 via email

@noahgh221
Copy link
Member

@rockivist I support your suggestion to add and have it follow the same convention as languagedeclaration, conventiondeclaration, and localtypedeclaration.

I think it would be desirable to accommodate local, not machine-actionable, rights statements in instead of recommending use of a separate element, but I can't quite think of an appropriate way to do that...

@rockivist
Copy link
Member Author

@noahgh221 In cases where the metadata isn't available under a shared, published license that can be referenced in an actionable way, there is always publicationstmt/p. Not perfect, but it's a fallback for unstructured rights info.

@SJagodzinski
Copy link

Mike,

ok you're right, I'm convinced. Following the other declarations here seems feasible. I agree with your suggestion.

@cannedit
Copy link
Contributor

Mike,

I agree with your proposal.

@rockivist
Copy link
Member Author

Thanks all! Will forward to TS-EAS.

@rockivist rockivist changed the title Add <rightsDeclaration> to <control> Add <rightsdeclaration> to <control> Feb 27, 2017
@rockivist
Copy link
Member Author

@fordmadox Testing successful in all six 1.1 release candidate schemas.

@rockivist
Copy link
Member Author

@fordmadox Testing successful in all six 1.1.2 release candidate schemas.

@noahgh221
Copy link
Member

Feature included in EAD3 v1.1.0 release. Closing issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

7 participants