Cataloguing Dates

Do

• Use origDate for dates of origin in the origin section. Use date elsewhere, for example in titles, names of people, etc. The rules for adding attributes are the same.
• Ensure that the text fully describes the date for display to users (e.g. include an indication of the calendar, such as by appending "CE" or "H"). This is what will be displayed on the web site. But it is not machine-readable, so you should also add attributes as described below, so the date can be indexed.
• Set the calendar attribute according to which calendar the text of the element expresses the date in (e.g. "#Hijri-qamari" if the date is given in the Islamic lunar calendar). If the text contains the date in two calendars, use the first, or consider splitting into two separate origDate elements.
• If a specific day, month or year is known, add a when attribute using the W3C date format (e.g. "1492", "1311-12", "1415-10-25") in the Gregorian calendar.
• If there is a range within which the manuscript (or part) originated, use notBefore and notAfter attributes, again with values that are W3C format dates in the Gregorian calendar. Also use those if the date is known to be a single year in one calendar, but that stretches across two years when converted.
• If only a beginning of a date range is known, use notBefore on its own. Likewise, if only a latest possible date for the origin of the manuscript (or part) is known, use notAfter on its own.
• If there are known specific dates for the beginning and end of production, use from and to attributes.
• If there is a gap between phases of creation (e.g. the text was created in the 13th century then illustrations added in the 15th century) then create two origDate elements.

Don't

• Do not mark up a statement that no date is known with origDate tags. Just include that as text within the origin element.
• Do not set the calendar attribute according to the date expressed in the other attributes. These must always be Gregorian dates in order for the web site to index dates consistently for all manuscripts in the collections but the calendar should not be set to "#Gregorian" unless that is how the date described in the text is expressed.
• Do not use something like "Gregorian" for the text (or delete such labels if they are what is present in a template). Ensure that they all contain text which fully describes the dates such that, if the XML tags were stripped out, it would still make sense as a piece of text (e.g. "1043 H, 1633-1634 CE")
• Do not combine the when attribute with notBefore, notAfter, from, and to.
• Do not use attributes such as atLeast, atMost, min, or max. These are valid, but the date-specific ones are better.
• Do not use the period attribute to record the calendar. It is for a named period of time (e.g. the reign of a monarch or a war.)

Optionally

• Use the cert attribute to record the degree of certainty of the date (the value should be one of: "low", "medium", "high", or "unknown).

Examples

Bad:  <origDate when="575" calendar="#Hijri-qamari">19th Ramadan 575</origDate>
Better: <origDate when="1180" calendar="#Hijri-qamari">19th Ramadan 575</origDate>
Best: <origDate when="1180-02-24" calendar="#Hijri-qamari">19th Ramadan 575</origDate>

Bad:  <origDate calendar="#Gregorian" notBefore="1272" notAfter="1273">671 H</origDate>
Good: <origDate calendar="#Hijri-qamari" notBefore="1272" notAfter="1273">671 H</origDate>

Bad:  <origin><origDate>No date</origDate></origin>
Good: <origin>No date</origin>