Re: [tei-council] Simple: Proposal for people/place/org

15 Jul 2016

      Thanks for this James. All very clear, and moderately easy to slide into 
the current draft.
However:

1. Do we REALLY want to include event, state, note as well as name ? I 
would have thought just name and note was enough. Otherwise, we need to 
explain when you use note, when event, and when state.
2. The current doc for Simple mentions only @when @calendar and @period 
of the datable attributes. Do we REALLY want @notBefore and @notAfter 
and @from and @to as well?
3. Adding name to the content models for person etc. is, strictly 
speaking, a non-conformant extension. I suggest you raise a feature 
request so we can slip it into the next release as part of the ongoing 
work to rationalise the content models  of ography-elements (they all 
currently have idno, so why not idno|name ?)
4. Your example is a nice way of paying respect, but I think the most 
likely use case envisaged for these elements in Simple-land would be to 
document info about fictional characters in plays etc. I'd prefer to 
replace the current example of the rev Opimiam etc. with the same thing 
done with person.

On 15/07/16 17:10, James Cummings wrote:
...
Hi Lou (and council and MartinM),
I was tasked making a Simple version of person/place/org for inclusion 
in TEI Simple headers.  My proposal is below, but includes one 
currently non-conformant change: allowing the <name> element in 
person/place/org (persName/placeName/orgName are allowed 
respectively). We don't want to add those other forms to TEI Simple, 
but need some way to provide the standardised name in all of these 
named entity elements. I wouldn't want TEI to be non-conformant, so it 
would need to be added to person/place generally -- it is already in 
org for some reason so doing this would provide more equivalence 
between the named entity elements.
My proposal is interspersed with bits of ODD for Lou to take into the 
Simple ODD if he agrees.
Overall elements I've cut down to what I view as the minimal number 
elements for providing basic person/place/org information.   I added 
to existing elements:
<moduleRef key="namesdates" include="event location state person 
place org"/>
  <moduleRef key="corpus" include="settingDesc particDesc"/>
  <classRef key="model.personLike"/>
  <classRef key="model.placeLike"/>
So that is event, location, state, person, place, and org from the 
namesdates module, and settingDesc and particDesc (for the place to 
put these people/place/org) from the corpus module. In most cases 
specialised elements inside person/place/org can be modelled with note 
(already in simple) and state. I've provided an exemplum for each of 
person/place/org. I've also suggested removing the alternation with 
model.pLike elements. Which would mean if you are doing TEI Simple 
then you can't just bung a paragraph in, but have to provide at least 
one element inside (such as <name>). This fits with the TEI Simple 
idea of trying to only have one way of doing things. Likewise for 
simple uses I've deemed listPerson, listPlace, listOrg as unnecessary.
In the case of attributes, the elements should be a member of whatever 
att.global classes simple uses, e.g. to get @xml:lang/@xml:id but I 
would remove att.editLike but retain att.sortable and att.typed (on 
org/place, people aren't already allowed to be typed... though I might 
argue against that) I'd retain any locally defined attributes. (e.g. 
@age/@role/@sex on person, since they can be used instead of some 
child elements)
PERSON
 <elementSpec xmlns="http://www.tei-c.org/ns/1.0" module="namesdates" 
ident="person" mode="change">
            <!-- It should be a member of whatever att.global classes 
simple uses, e.g. to get @xml:lang/@xml:id but I would remove 
att.editLike but retain att.sortable
            I would retain the locally defined attributes of @role, 
@sex, and @age
            -->
            <classes mode="replace">
              <memberOf key="model.personLike"/>
              <memberOf key="att.sortable"/>
              <!-- att.global gets too much. All I'd recommend is 
xml:lang, xml:id, n; ana; cert, resp; corresp; for person/place/org -->
              </classes>
            <!-- I would only allow name, bibl, state, event, idno, 
bibl, and note. Except for name, that is a subset of current content 
model. I'd remove
            optional alternation with pLike -->
            <content>
                <alternate minOccurs="1" maxOccurs="unbounded">
                  <!-- name is currently *not* allowed inside 
<person>, only <persName>. We don't want to add that back, so should 
we allow <name> in larger TEI? -->
                  <elementRef key="name"/>
                  <elementRef key="bibl"/>
                  <elementRef key="state"/>
                  <elementRef key="event"/>
                  <elementRef key="idno"/>
                  <elementRef key="note"/>
               </alternate>
            </content>
<exemplum>
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <person xml:id="SPQR" age="61" sex="m">
                  <name type="person">
                    <name type="forename">Sebastian</name>
                    <name type="forename">Patrick</name>
                    <name type="forename">Quintus</name>
                    <name type="surname">Rahtz</name>
                  </name>
                  <event type="birth" when="1955-02-13">
                    <ab>13 February 1955</ab>
                  </event>
                  <event type="death" when="2016-03-15">
                    <ab>15 March 2016</ab>
                  </event>
                  <state type="affiliation" notBefore="1999" 
notAfter="2012">
                    <ab>Oxford University Computing Services, 
University of Oxford</ab>
                  </state>
                  <state type="affiliation" notBefore="2012" 
notAfter="2015" corresp="#Ox_IT">
                    <ab>IT Services, University of Oxford</ab>
                  </state>
                  <state type="nationality">
                    <ab>British</ab>
                  </state>
                  <note>The production and release process for TEI P5 
was originally developed by
                    Sebastian Rahtz for the TEI Technical Council.</note>
                </person>
              </egXML>
            </exemplum>
          </elementSpec>
ORG
<elementSpec xmlns="http://www.tei-c.org/ns/1.0" 
module="namesdates" ident="org" mode="change">
            <!-- It should be a member of whatever att.global classes 
simple uses, e.g. to get @xml:lang/@xml:id but I would remove 
att.editLike but retain att.sortable and att.typed
            I would retain the locally defined attribute of @role
            -->
            <classes mode="replace">
              <memberOf key="model.personLike"/>
              <memberOf key="att.typed"/>
              <memberOf key="att.sortable"/>
              <!-- att.global gets too much. All I'd recommend is 
xml:lang, xml:id, n; ana; cert, resp; corresp; for person/place/org -->
            </classes>
            <!-- I would only allow name, bibl, state, event, idno, 
bibl, location, and note. I'd remove
            optional alternation with pLike and nesting of org -->
            <content>
              <alternate minOccurs="1" maxOccurs="unbounded">
                <elementRef key="name"/>
                <elementRef key="bibl"/>
                <elementRef key="state"/>
                <elementRef key="event"/>
                <elementRef key="idno"/>
                <elementRef key="note"/>
                <elementRef key="location"/>
              </alternate>
            </content>
            <exemplum>
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <org xml:id="Ox_IT">
                  <name type="org" notBefore="2012">IT Services, 
University of Oxford</name>
                  <name type="org" notAfter="2102">Oxford University 
Computing Services, University of
                    Oxford</name>
                  <location>
                    <address>
                      <addrLine n="street">13 Banbury Road,</addrLine>
                      <addrLine n="city">Oxford</addrLine>
                      <addrLine n="postcode">OX2 6NN</addrLine>
                      <addrLine n="country">United Kingdom</addrLine>
                    </address>
                  </location>
                  <event when="2012">
                    <ab>Oxford University Computing Services, 
University of Oxford, merged with two
                      other departments in 2012 to form IT Services.</ab>
                  </event>
                </org>
              </egXML>
            </exemplum>
          </elementSpec>
PLACE
<elementSpec xmlns="http://www.tei-c.org/ns/1.0" 
module="namesdates" ident="place" mode="change">
            <!-- It should be a member of whatever att.global classes 
simple uses, e.g. to get @xml:lang/@xml:id but I would remove 
att.editLike but retain att.sortable and att.typed
            I would retain the locally defined attribute of @role
            -->
            <classes mode="replace">
              <memberOf key="model.placeLike"/>
              <memberOf key="att.typed"/>
              <memberOf key="att.sortable"/>
              <!-- att.global gets too much. All I'd recommend is 
xml:lang, xml:id, n; ana; cert, resp; corresp; for person/place/org -->
            </classes>
            <!-- I would only allow name, bibl, state, event, idno, 
bibl, location, and note. I'd remove
            optional alternation with pLike and nesting of place. As 
with person I would add name -->
            <content>
              <alternate minOccurs="1" maxOccurs="unbounded">
                <elementRef key="name"/>
                <elementRef key="bibl"/>
                <elementRef key="state"/>
                <elementRef key="event"/>
                <elementRef key="idno"/>
                <elementRef key="note"/>
                <elementRef key="location"/>
              </alternate>
            </content>
            <exemplum>
              <egXML xmlns="http://www.tei-c.org/ns/Examples">
                <place xml:lang="Bristol" type="city">
                  <name xml:lang="en">Bristol</name>
                  <name xml:lang="ang">Brycgstow</name>
                  <name type="country">United Kingdom</name>
                  <event when="1155" type="foundation">
                    <ab>Royal charter granted</ab>
                  </event>
                  <location>
                    <num type="geo">51.45, -2.583333</num>
                  </location>
                  <state type="climate">
                    <ab>Climate data from Bristol Weather Centre 1971 
- 2000 shows an average high
                      temperature of 7.5 - 22 degrees celcius, and an 
average low temperature of 2.9
                      - 14.3 degrees celcius.</ab>
                  </state>
                </place>
              </egXML>
            </exemplum>
          </elementSpec>
Happy to entertain modifications to this initial proposal.
-James

Re: [tei-council] Simple: Proposal for people/place/org

Lou Burnard