Review & revise METS overview

mets / METS-board

Documents and wiki pages relevant to the business of the METS Editorial Board

14 stars 6 forks source link

Review & revise METS overview #31

Open aelkiss opened 5 years ago

aelkiss commented 5 years ago

This is a very old document, and there are likely several things that need to be updated or corrected.

aelkiss commented 5 years ago

I will send the link to the board and everyone will have a look.

aelkiss commented 5 years ago

The version in the repository is: https://github.com/mets/METS-board/blob/master/web%20documents/metsoverview.md

aelkiss commented 5 years ago

There are also translations at http://www.loc.gov/standards/mets/mets-schemadocs.html

Some are HTML (French, Spanish, Italian, Portuguese, German); Persian is PDF and simplified and traditional Chinese are word docs.

We should convert the non-HTML ones to HTML if possible.
The XML in the translations should be updated as well (see #20, #34).

And most relevantly to this issue:

If we make substantive updates to the English version, we should update the translations as well.

aelkiss commented 5 years ago

The consensus at the board meeting today was that we should remove the information behaviorSec from the overview as it is not used in the form here. We will go ahead and merge #35 and #36.

aelkiss commented 5 years ago

For the translations, we should provide a diff with the updates we made to the mailing list and ask people for contributions.

I think it would probably be worthwhile to at least update the XML in the translations (and put them here in markdown). I will plan on doing that.

aelkiss commented 5 years ago

Merged changes from #35 and #36. I will attempt to convert the translations to markdown and make a summary of the changes that should be applied to the translations as well.

aelkiss commented 5 years ago

I converted all the translations except Persian to markdown, and applied the XML updates.

Here is a comparison that shows the changes in the text that would need to be applied to the translations:

https://github.com/mets/METS-board/compare/6e9ca8d..master

Changes include rewriting the introduction and changing "digital library objects" to "digital objects", along with a few other minor edits.

aelkiss commented 5 years ago

There is a Russian translation we should add: https://www.prlib.ru/sites/default/files/u535/mets_overview_rus.pdf

aelkiss commented 5 years ago

Bertrand will update the French translation and possibly the Spanish one. Aaron will ask Angela if she can update the Italian one. Andreas will update the German one. Karin will ask José Borbinha (the original translator for the Portuguese one) We aren't sure who produced the Chinese one. Karin will reach out to the Russian translators. Aaron will copy the Russian translation into the Markdown format & apply the XML updates. We aren't sure who created the Persian translation either.

I will create a new ticket for each translation for easier tracking.

BertrandCaron commented 5 years ago

@aelkiss I can't find the HTML-converted translations... can you point me to their location in Github?

aelkiss commented 5 years ago

@BertrandCaron They are on the "overview_translations" branch. Here is the French one: https://github.com/mets/METS-board/blob/overview_translations/web%20documents/metsoverview_fr.md

andreasnef commented 5 years ago

Updated German translation see https://github.com/mets/METS-board/pull/39