Front Matter Documentation Feedback

>>Return to testing instructions: Feedback_on_the_Best_Practices_for_TEI_in_Libraries_ODD_Documentation_and_Schemas

Tester: Melanie Schlosser

Comments/Feedback

• In the ODD HTML file, sections 4.1 and 4.1.8 are missing their section headers, which messes up the ToC. The title for 4.1 is, presumably, "The TEI Header," but I couldn't figure out what the title for 4.1.8 is supposed to be. The content in that section isn't in the wiki documentation.
• Formatting/rendition issues in the ODD HTML
  • Quotation marks in examples sometimes display incorrectly. Sometimes they are rendered as a vertical bar (Example: 3.2.1.), and sometimes they cause a new paragraph to start (Example: 4.1.2)
  • Missing paragraph breaks. This happens most often in the table with the element and attribute recommendations, but it also happens all through sections 4.1.3-4.1.5.
  • Table formatting
    • The tables don't have borders between cells, which would make them easier to read
    • Almost all of the text formatting inside the table cells is wonky, including paragraph breaks, lists, and more. The first good example is in the element recommendations table under <title type=" ">
• In the Introduction, the table that briefly describes the encoding levels is somewhat confusing - mostly because of the third column ("Example of encoding of Alger Hiss document"). This isn't explained previously, and the links in that column take you to page images, not markup. A couple sentences explaining what that column is would be helpful.
• These are the same in the wiki documentation, but I found a few instances of typos or unclear wording:
  • Section 2 (Relationship to TEI Tite): At the end of the first sentence, 'organization' should be 'organizations.'
  • In the second paragraph of that same section, it talks about "mass digitization of born-digital source documents." What does that mean?
  • In section 4.1.1 (Reference), in the first sentence, "It is just one specification group that is used be each of the..." Huh?

Tester: Enter Your Name

Comments/Feedback

• List feedback, problems encountered, etc. in bulleted list form. Provide detailed examples please so that we may make corrections more easily.
• Feedback
• Feedback

Tester: Enter Your Name

Comments/Feedback

• List feedback, problems encountered, etc. in bulleted list form. Provide detailed examples please so that we may make corrections more easily.
• Feedback
• Feedback