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

Split up chapter 2, 3, 4 #4

Draft
wants to merge 12 commits into
base: main
Choose a base branch
from
Draft

Split up chapter 2, 3, 4 #4

wants to merge 12 commits into from

Conversation

aelkiss
Copy link
Contributor

@aelkiss aelkiss commented Sep 4, 2024

This splits up chapters 2, 3, and 4, and largely removes the linear "chapter" wording from previous versions.

Would be good to discuss next week what work remains to get this to a publishable version for METS 2.

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 4, 2024

@jmlehton this incorporates work from the ch3-split branch

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 4, 2024

The biggest remaining tasks specifically here that I see are to:

  • integrate the new example for METS 2
  • consider merging content from former chapter 2 and chapter 3 (now the authoring and schema-perspective subdirectories respectively)

@jmlehton
Copy link
Contributor

@jmlehton this incorporates work from the ch3-split branch

Thanks. Now these are the divided by the main sections of METS 2, but some chapters are still very long. Let's discuss in the meeting how we should proceed. Also, the new example may affect on this.

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 11, 2024

The content in the 'authoring' section also needs to be revised for METS 2.

We still want to split up the content from former chapter 3 further. One arrangement could be:

  • content from "authoring" and introductory content to each section for "schema perspective" can be moved to a new section like "major sections of the METS document" (tbd)
  • information on specific elements in the schema perspective can be moved to sub pages and organized along with the 'use cases'. There might be some duplicative material here, or places where we can link back and forth.

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 11, 2024

We can also use collapsible sections for the example code: https://gist.github.com/pierrejoubert73/902cc94d79424356a8d20be2b382e1ab

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 11, 2024

We should also remove any extraneous comments and notes. There are some placeholders like [image] where there were previously images in the word version. Could be useful to have some images to keep track of where you are in the structure, but that can be the last thing to work on.

@aelkiss
Copy link
Contributor Author

aelkiss commented Sep 11, 2024

Let's try to have everything split up further by October 9th (I can work on it some before then) and then split up the task of integrating the new examples.

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

Successfully merging this pull request may close these issues.

2 participants