search

ilrt / Beyond2022TeiTemplate

Work on creating a template for the TEI/XML that will be used in the Medieval Gold Seam and other seams
2 stars 0 forks source link

Convention for giving a title to a document? #1

Closed MikeJ1971 closed 3 years ago

MikeJ1971 commented 3 years ago

What will be the convention on naming the document? This might be what appears in search results.

In the example, I've based it of the series as described in Paul's stylebook but added the regnal year. If we refer to The National Archives should it be disambiguated, e.g. 'The National Archives, Kew'?

Example title:

<title>Receipt Roll of the Irish Exchequer for 29 and 30 Edward I (The National Archives, E 101)</title>

See https://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-titleStmt.html See https://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-title.html

crooksp commented 3 years ago

I imagine we will use the title from the Discovery Catalogue for the roll in question, which should in turn become the title in the ISAD(G) statement for the record.

pdryburgh commented 3 years ago

We should use the Discovery description where appropriate, I agree. It may be we are able to add our own amendments or revisions upon detailed analysis - Discovery can always be changed!

MikeJ1971 commented 3 years ago

Ok, using the Description in the CSV file sent by Paul, the title for the example would change from ...

<title>Receipt Roll of the Irish Exchequer for 29 and 30 Edward I (The National Archives, E 101)</title>

to ...

<title>Roll of receipts. 29 and 30 Edw I 18 membranes.</title>

Does this give enough details/context?

MikeJ1971 commented 3 years ago

Membranes should be in the extent.

MikeJ1971 commented 3 years ago

We will go with:

<title>Receipt Roll of the Irish Exchequer for 29 and 30 Edward I</title>

Needs further discussion on dates and their representation.

MikeJ1971 commented 3 years ago

Ok, I think we agreed to use Discovery as a basis, but with the option to amend or provide a more meaningful or descriptive title. In the case of the example, we've gone with:

         <titleStmt>
            <title>Receipt roll of the Irish Exchequer for 29 and 30 Edward I (The National
               Archives, E 101/233/16)</title>
         </titleStmt>
crooksp commented 3 years ago

hi Mike,

I am worried that we are mixing up here the Title and Reference Code. I would prefer if the title was in the form "Receipt roll of the Irish Exchequer for 29 and 30 Edward I", and we keep the reference code "The National Archives, E 101/233/16" distinct.

The reason for this is to future proof. If we were, in the future, doing a TEI edition of a Memoranda Roll, there would be no original, so the Title would be "Memoranda roll of the Irish Exchequer for 29 and 30 Edward I", but there could be multiple replacement sources whose reference codes would need to be included.

Does that make any sense?

Peter

MikeJ1971 commented 3 years ago

Of course. I think I misunderstood. I'll fix that now.

On Fri, 11 Sep 2020 at 09:54, crooksp notifications@github.com wrote:

hi Mike,

I am worried that we are mixing up here the Title and Reference Code. I would prefer if the title was in the form "Receipt roll of the Irish Exchequer for 29 and 30 Edward I", and we keep the reference code "The National Archives, E 101/233/16" distinct.

The reason for this is to future proof. If we were, in the future, doing a TEI edition of a Memoranda Roll, there would be no original, so the Title would be "Memoranda roll of the Irish Exchequer for 29 and 30 Edward I", but there could be multiple replacement sources whose reference codes would need to be included.

Does that make any sense?

Peter

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/ilrt/Beyond2022TeiTemplate/issues/1#issuecomment-690965965, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAAH5R53C4WPKAI2R7YHKZTSFHQVXANCNFSM4PTEN4DQ .

crooksp commented 3 years ago

No problem -- this bit of conceptualization is the hardest thing to imagine in the abstract, and I am still working it out. At the next step, let's involve Gary to check our logic and choices.

MikeJ1971 commented 3 years ago

I've updated the example.

munnellg commented 3 years ago

Just to be clear, there's nothing wrong with putting the reference code in the title if you like, but the database won't know to look for it there. If you want to fetch manuscript E 101, then this code must appear in the reference code DB database table.

That being said, for display purposes, you may like to have the reference code in the title. But that is entirely up to what you want to see in a title field when rendering a document on a web page. Of course, we can automatically append a reference code to the title if both are in the DB.