Difference between revisions of "Copyediting Feedback"

From TEIWiki
Jump to navigation Jump to search
m
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
[http://wiki.tei-c.org/index.php/TEI_in_Libraries:_Guidelines_for_Best_Practices Back to GBP]
 
[http://wiki.tei-c.org/index.php/TEI_in_Libraries:_Guidelines_for_Best_Practices Back to GBP]
  
 +
* "TEI Header" in headings; "teiHeader" as element tag; "TEI header" in text. --[[User:Lorand|Susie]]
  
−
* Copyedit the text so that we use terms like "item", "work", "tag", "element", "project", and "collection". consistently. Also check that we speak with a consistent voice: "the encoder should" vs. "the encoder must" vs. "the encoder will".
+
* Referencing elements and attributes: pointy brackets around element names when the word "element" is not present; monospace for both attributes and elements. I recommend against @ signs for attributes even though the main TEI Guidelines use them, because they are confusing to the uninitiated. Quotation marks are used around attribute ''values'' (not attribute names). --[[User:Lorand|Susie]]
  
−
* Copyedit throughout: "TEI Header", "teiHeader", "header", "Header".
+
* "OCR" (not spelled out) and "optical character recognition" (lowercase) --[[User:Lorand|Susie]]
  
−
* Standardize how we reference elements and attributes -- sometimes with pointy brackets, sometimes monospace, sometimes both, sometimes in quotes, sometimes with no differentiating characters or font style.
+
* throughout: <teiHeader> <tt>&lt;!-- header goes here --&gt;</tt> </teiHeader> --[[User:Lorand|Susie]]
−
** elements should be referenced one way (monospace?)
 
−
** attributes another (in quotes, with the @ as the preface?)
 
  
−
* expand abbreviations and acronyms the first time mentioned
+
* Try to find a more generic heading for the Alger Hiss document examples? --[[User:Lorand|Susie]]
  
−
* do we need parentheses here? "that holds chapter 3 (rather than near the bottom of the <div> that holds chapter 2)."[[User:Natasha|Natasha]]
+
* When review of guidelines in the wiki is finished, remove redundancies from section headings ("Level 3" and "Level 4" in subheadings under "Level 3 Examples" and "General Level 4 Recommendations and Examples" ----[[User:Lorand|Susie]]
−
* Copyedit through the whole text: "OCR" (not spelled out) and "Optical Character Recognition" [[User:Natasha|Natasha]] Actually, "optical character recognition" (lowercase) is OK --[[User:Lorand|Susie]]
 
−
* throughout:
 
−
**  <teiHeader> [stuff] </teiHeader>
 
−
** <teiHeader> [info] </teiHeader>
 
−
**<teiHeader>  [Source and processing information goes here] </teiHeader>
 
  
−
What do we choose? [[User:Natasha|Natasha]]
+
* I have moved source citations to the ends of examples if they weren't there already, and introduced them with "Source" rather than "FROM". Examples in the following subsections lack citations:
−
 
+
** Level 3 Basic Structure: Verse
−
* <tt>&lt;!-- header goes here --&gt; --[[User:Lorand|Susie]]
+
** Level 3 Chapter with Letter
 +
** Level 4 Name Tagging
 +
** Level 4 Oral History
 +
** Alger Hiss document (Levels 1, 2, 3, 4)
  
 
[[Category:SIG:Libraries]]
 
[[Category:SIG:Libraries]]

Latest revision as of 23:57, 21 April 2009

Back to GBP

  • "TEI Header" in headings; "teiHeader" as element tag; "TEI header" in text. --Susie
  • Referencing elements and attributes: pointy brackets around element names when the word "element" is not present; monospace for both attributes and elements. I recommend against @ signs for attributes even though the main TEI Guidelines use them, because they are confusing to the uninitiated. Quotation marks are used around attribute values (not attribute names). --Susie
  • "OCR" (not spelled out) and "optical character recognition" (lowercase) --Susie
  • throughout: <teiHeader> <!-- header goes here --> </teiHeader> --Susie
  • Try to find a more generic heading for the Alger Hiss document examples? --Susie
  • When review of guidelines in the wiki is finished, remove redundancies from section headings ("Level 3" and "Level 4" in subheadings under "Level 3 Examples" and "General Level 4 Recommendations and Examples" ----Susie
  • I have moved source citations to the ends of examples if they weren't there already, and introduced them with "Source" rather than "FROM". Examples in the following subsections lack citations:
    • Level 3 Basic Structure: Verse
    • Level 3 Chapter with Letter
    • Level 4 Name Tagging
    • Level 4 Oral History
    • Alger Hiss document (Levels 1, 2, 3, 4)
Retrieved from "https://wiki.tei-c.org/index.php?title=Copyediting_Feedback&oldid=6278"