BPG Revision 3 Public Comment Feedback - Revision history

Kshawkin: /* Level 4, Basic Content Analysis */ fixed wiki markup

2009-05-10T19:46:02Z

‎Level 4, Basic Content Analysis: fixed wiki markup

Kshawkin: Reverted edits by Kshawkin (Talk); changed back to last version by Mdalmau

2009-05-06T18:41:19Z

Reverted edits by Kshawkin (Talk); changed back to last version by Mdalmau

Kshawkin: /* On Page Breaks */ wiki markup

2009-05-06T18:39:14Z

‎On Page Breaks: wiki markup

Kshawkin: /* Level 4, Basic Content Analysis */ TEI markup now shows

2009-05-06T16:42:35Z

‎Level 4, Basic Content Analysis: TEI markup now shows

Mdalmau: /* Public Comment Feedback */

2009-05-06T15:40:08Z

‎Public Comment Feedback

Mdalmau at 15:39, 6 May 2009

2009-05-06T15:39:12Z

Mdalmau: /* TEI Header */

2009-05-06T13:39:45Z

‎TEI Header

Mdalmau: /* Public Comment Feedback */

2009-05-06T13:13:15Z

‎Public Comment Feedback

Mdalmau: /* TEI Header */

2009-05-06T13:04:53Z

‎TEI Header

Mdalmau: /* General recommendations/comments */

2009-05-06T13:02:08Z

‎General recommendations/comments

@@ Line 32: / Line 32: @@
 * Perhaps add a column indicating the TEI Tite equivalents?
-* in General Level 4 Recommendations and Examples the examples have (eg) <del rend="overstrike" hand="JHL">their manner</del> which I suspect should be <del rend="overstrike" hand="#JHL">their manner</del> since the datatype of @hand is data.pointer.
+* in General Level 4 Recommendations and Examples the examples have (eg) <tt>&lt;del rend="overstrike" hand="JHL"&gt;their manner&lt;/del&gt;</tt> which I suspect should be <tt>&lt;del rend="overstrike" hand="#JHL"&gt;their manner&lt;/del&gt;</tt> since the datatype of @hand is data.pointer.
 ** Eek! Of course, you are correct. But it's worse than that, because apparently no one has edited this example yet at all. The values of rend= don't match the recommendations made later in the same document (not a real problem, in my book, as rend= is such a variable), but worst of all, by far, the example is not well-formed (there is an "&" on the last line)!

@@ Line 32: / Line 32: @@
 * Perhaps add a column indicating the TEI Tite equivalents?
-* in General Level 4 Recommendations and Examples the examples have (eg) <code>&lt;del rend="overstrike" hand="JHL">their manner</del></code> which I suspect should be <code>&lt;del rend="overstrike" hand="#JHL">their manner</del></code> since the datatype of @hand is data.pointer.
+* in General Level 4 Recommendations and Examples the examples have (eg) <del rend="overstrike" hand="JHL">their manner</del> which I suspect should be <del rend="overstrike" hand="#JHL">their manner</del> since the datatype of @hand is data.pointer.
 ** Eek! Of course, you are correct. But it's worse than that, because apparently no one has edited this example yet at all. The values of rend= don't match the recommendations made later in the same document (not a real problem, in my book, as rend= is such a variable), but worst of all, by far, the example is not well-formed (there is an "&" on the last line)!
@@ Line 56: / Line 56: @@
 === On Page Breaks ===
-* "Page breaks should be encoded using the pb element," maybe better: "using <code>&lt;pb/></code>."
+* "Page breaks should be encoded using the pb element," maybe better: "using <pb/>."
-* I find the text a bit confusing, as "should always be contained within a text division" ok, so no ..<code>&lt;/div><pb/><div></code>... but I don't see that "contained within a text division" implies: "(rather than before the <code>&lt;/div></code> that ends chapter 2)" (although I do agree that <code>&lt;/div><div><pb/></code> is better)
+* I find the text a bit confusing, as "should always be contained within a text division" ok, so no ..</div><pb/><div>... but I don't see that "contained within a text division" implies: "(rather than before the </div> that ends chapter 2)" (although I do agree that </div><div><pb/> is better)
 === On Levels ===

@@ Line 56: / Line 56: @@
 === On Page Breaks ===
-* "Page breaks should be encoded using the pb element," maybe better: "using <pb/>."
+* "Page breaks should be encoded using the pb element," maybe better: "using <code>&lt;pb/></code>."
-* I find the text a bit confusing, as "should always be contained within a text division" ok, so no ..</div><pb/><div>... but I don't see that "contained within a text division" implies: "(rather than before the </div> that ends chapter 2)" (although I do agree that </div><div><pb/> is better)
+* I find the text a bit confusing, as "should always be contained within a text division" ok, so no ..<code>&lt;/div><pb/><div></code>... but I don't see that "contained within a text division" implies: "(rather than before the <code>&lt;/div></code> that ends chapter 2)" (although I do agree that <code>&lt;/div><div><pb/></code> is better)
 === On Levels ===

@@ Line 32: / Line 32: @@
 * Perhaps add a column indicating the TEI Tite equivalents?
-* in General Level 4 Recommendations and Examples the examples have (eg) <del rend="overstrike" hand="JHL">their manner</del> which I suspect should be <del rend="overstrike" hand="#JHL">their manner</del> since the datatype of @hand is data.pointer.
+* in General Level 4 Recommendations and Examples the examples have (eg) <code>&lt;del rend="overstrike" hand="JHL">their manner</del></code> which I suspect should be <code>&lt;del rend="overstrike" hand="#JHL">their manner</del></code> since the datatype of @hand is data.pointer.
 ** Eek! Of course, you are correct. But it's worse than that, because apparently no one has edited this example yet at all. The values of rend= don't match the recommendations made later in the same document (not a real problem, in my book, as rend= is such a variable), but worst of all, by far, the example is not well-formed (there is an "&" on the last line)!

@@ Line 4: / Line 4: @@
 = Public Comment Feedback =
-Posted below are public comments we have received as of May 6, 2009, 9:12 EST for review during our DLF-sponsored meeting on May 6th. Most comments, except for two, posted thus far have been on the TEILIB-L list.  The non-list feedback was sent directly to Kevin and Michelle or were part of the BOF discussion and were anonymized.
+Posted below are public comments we have received as of May 6, 2009, 11:39 EST for review during our DLF-sponsored meeting on May 6th. Most comments, except for two, posted thus far have been on the TEILIB-L list.  The non-list feedback was sent directly to Kevin and Michelle or were part of the BOF discussion and were anonymized.
 Comments can also be followed by searching the TEILIB-L Archive, April 2009, Week 4 threads:

@@ Line 50: / Line 50: @@
 * Soft hyphens at the end of a line or page were the greatest sinners in terms of unnecessary variance across projects [harvesting texts]. The new guidelines say nothing about EOL phenomena, but this seems to me an area where you can make things simpler for diverse users by nailing down a single practice as a firm standard. Using \u2011 consistently would help.
 * Outsource workflow scenario (needs to be developed, but Tite is a related workflow); Develop and integrate workflows
+* that the Guidelines encourage the use of unicode rather than named character entities
 === On Filenames ===

@@ Line 19: / Line 19: @@
 * The recommendations for imprint/pubPlace and imprint/publisher (within sourceDesc) reference "ISBN" punctuation, but this should be "ISBD" punctuation.
 * Provide guidance for how deep to go into the header structure (whether MARC-based or not) and provide rationale for why certain tags (i.e., biblStruct) are recommended
 == Level 1, Fully Automated Conversion and Encoding ==

@@ Line 17: / Line 17: @@
 * "Each <respStmt> must have only one resp child element and one name element, though they may occur in either order." This is rather harsh. TEI doesn't enforce this, and it can lead to massive redundancy, if one <resp> is shared by lots of people. Is there good reasons to limit it this way? I don't see programs having a problem with resp+,name+
 * I am missing profileDesc/langUsage - I guess that if everything is en(g) then why bother, but if your scope is any language?
 * The recommendations for imprint/pubPlace and imprint/publisher (within sourceDesc) reference "ISBN" punctuation, but this should be "ISBD" punctuation.
 == Level 1, Fully Automated Conversion and Encoding ==