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
 * 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