8000 schema: remodel role-specific elements in work and expression by pe-ro · Pull Request #1370 · music-encoding/music-encoding · GitHub
[go: up one dir, main page]

Skip to content

schema: remodel role-specific elements in work and expression #1370

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

Closed
wants to merge 8 commits into from

Conversation

pe-ro
Copy link
Contributor
@pe-ro pe-ro commented Sep 26, 2023

This PR is one of a number of replacements for PR #799

@pe-ro pe-ro added this to the MEI 6 milestone Sep 26, 2023
@github-actions github-actions bot added the Component: Core Schema changes to source/modules/* (assigned automatically) label Sep 26, 2023
…ements

Remove membership in respLikePart for
- arranger;
- funder;
- librettist;
- lyricist; and
- sponsor
This PR addresses in part PR #799
@rettinghaus
Copy link
Member

Why can't we continue with #799?
It was noted before, that "Reviewers review proposals. They do not suggest their own because they don't like the original."

@pe-ro
Copy link
Contributor Author
pe-ro commented Sep 27, 2023

@rettinghaus, by all means continue with PR #799. I hope you'll note my comments there -- comments which led to creation of a this PR which has the same motivation as #799 but accomplishes the goal with different means.

Of course reviewers review, but a PR should not be granted an automatic approval either.

@ahankinson
Copy link
Member

Yeah, I think this duplicates the work done in #799 ... This PR removes these elements without also replacing them with something, meaning that merging this will leave MEI in a state where we remove the ability to describe a composer or an author, without also having a replacement method. I know this is only in development, but it would be good to have removals and replacement solutions together, IMO.

@pe-ro
Copy link
Contributor Author
pe-ro commented Sep 28, 2023

Sorry for the confusion. The separation of this PR from #1371 is due to 2 things:

  • an attempt (perhaps misguided) to create requests that are as atomic as possible; and
  • my lack of knowledge of how to create a single PR that includes changes to multiple files.

@bwbohl
Copy link
Member
bwbohl commented Oct 19, 2023

Sorry for the confusion. The separation of this PR from #1371 is due to 2 things:

  • an attempt (perhaps misguided) to create requests that are as atomic as possible; and
  • my lack of knowledge of how to create a single PR that includes changes to multiple files.

Ok, I understand. So, the duplication is due to workflow issues. If I analyze the situation correctly, you, @pe-ro, are using the GitHub web interface for making your modifications to the files in the develop branch. This results in a new branch and pull request for every file you change. This is a bit cumbersome to maintain for reviewers, as they have to keep track of all the branches and pull requests that should go together.

The best option in case of an existing PR that wants to achieve a similar thing would be to make use of the comment and, most importantly, code-line comments (which, btw. also allow direct alternative code suggestions that could be merged into the PR after the discussion is resolved).

In general, if you want to modify multiple files, the most common way would be to clone the repository to your machine, create a new branch there, and then make granular commits to that branch for every change you make, e.g., commit 1 : remove author and composer; commit 2: relax model of work, and so forth.

If you want or have to use GitHub’s web interface, you could also create a branch first, then switch to that branch (instead of develop) make your changes to a single file and commit it directly to that newly created branch (each with sound granularity and change description). After you have completed all your changes for the goal you want to achieve, you can open a new pull request from your branch against develop. Consequently, there would be just one pull request, with all the changes needed to make it a sound and round code-suggestions^.

Given the situation we have right now I would propose the following workflow.

  1. We mark this PR a draft.
  2. We merge all your PRs that should go together into one single branch that is not develop; If I get it right this would mean merging Modify role specific elements #1371, Modify content model of work #1372, and Modify content model of expression #1373 into the branch of schema: remodel role-specific elements in work and expression #1370 (being this PR; code of which is in the branch develop-agents). After that, the two concurring PRs can be compared more easily.
  3. We transfer the changes of this (your) PR to comments and code-suggestions in schema: create agent in MEI shared #799; this way all the proposed modifications and the discussion are in the same place and easier to review.

This sound good?

@pe-ro
Copy link
Contributor Author
pe-ro commented Nov 13, 2023

@bwbohl, sorry for not responding to this sooner. Thanks for helping me out. I think it will be easier for everyone, including me, to remove/mark-as-a-draft/whatever the pull requests I submitted earlier and for me to follow your instructions on using the GitHub interface to submit a single, comprehensive pull request. There will be a large number of revisions, but the logic will be easier to follow overall.

@bwbohl
Copy link
Member
bwbohl commented Nov 13, 2023

Hey @pe-ro, thanks for coming back to this. Never mind any delays, we all are doing this with the time we can spare ;-)
I changed the base of the PRs mentioned above to the develop-agents branch so we can merge them.

@pe-ro
Copy link
Contributor Author
pe-ro commented Nov 13, 2023

Sorry, now I'm more confused. Should I create a new pull request from a new branch or leave things as they are?

@bwbohl
Copy link
Member
bwbohl commented Nov 13, 2023

We can just merge these PRs to other branches than develop, namely the develop-agents branch. This way, everything comes together in one, and we can pimp up the explanation here. How does that sound?

@pe-ro
Copy link
Contributor Author
pe-ro commented Nov 13, 2023

If that's easier for you, it's fine by me. Is anything else required of me?

@bwbohl
Copy link
Member
bwbohl commented Nov 13, 2023

I could just merge them

Modify role specific elements

Yes, this is an alternative to the creation of <agent>. In my opinion, the proposal to create <agent> as a replacement for the various role-specific elements

places too much of a burden on the encoder to specify the nature of the agent's relationship to the bibliographic item; and
doesn't help clarify that some agents are privileged in some styles of bibliographic description. Allowing some roles to be "singled out" makes it easier to transcode from existing markup like MARC and MODS.
<creator> and <editor> can mark those privileged roles and other roles can go into <respStmt>. As I've said elsewhere, if treating some roles as special offends the encoder's sensibilities, then all roles can go into <respStmt> since <respStmt> retains its former children, i.e., <resp> and name-lIke elements.

<creator>, <editor> and <resp> are all places where authority attributes (@auth and @auth.uri) can be used to provide pointers to standard values for the agent-to-item relationship. While the name-like elements (<name>, <persName>, and <corpName>) can use these same attributes for pointers to standardized / variant names for these entities.
@pe-ro
Copy link
Contributor Author
pe-ro commented Nov 13, 2023

OK, but there will be conflicts between my suggestions and those of #799.

@bwbohl
Copy link
Member
bwbohl commented Nov 13, 2023

Yeah, that's why I merged your other develo-agentX branches here. Now we have your proposal in one place and can proceed e.g. by comparing this branch to the one of #799

@bwbohl bwbohl changed the title Remove author and composer elements Remodel role-specific elements in work and expression Nov 13, 2023
@pe-ro
Copy link
Contributor Author
pe-ro commented Nov 13, 2023

Got it. Thanks again.

@musicEnfanthen musicEnfanthen changed the title Remodel role-specific elements in work and expression schema: remodel role-specific elements in work and expression Nov 24, 2023
@bwbohl bwbohl mentioned this pull request Feb 28, 2024
@musicEnfanthen musicEnfanthen mentioned this pull request Jan 31, 2025
18 tasks
@riedde riedde moved this from Done to In review in IG Metadata Meetings Mar 11, 2025
@bwbohl bwbohl closed this in #1596 Jul 25, 2025
@github-project-automation github-project-automation bot moved this from In review to Done in IG Metadata Meetings Jul 25, 2025
@github-project-automation
7D4D
github-project-automation bot moved this from 🆕 New to ✅ Done in ODD meetings Jul 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Component: Core Schema changes to source/modules/* (assigned automatically)
Projects
Status: Done
Status: ✅ Done
Development

Successfully merging this pull request may close these issues.

4 participants
0