#2 Need for tag documentation

closed
nobody
5
2006-09-25
2004-05-20
Anonymous
No

I am familiar with TEI lite.

When the standard is converted to a Schema, I strongly
recommend that you provide a very detailed tag library.
Schemas are very difficult to read and interpret. A good
model for documentation would be the EAD tag library at
http://www.loc.gov/ead/tglib/index.html.

Each tag is defined, and possible parent and child tags
for the given tag are listed. Examples are also provided.

The EAD Tag Library also has a good explanation of
linking tags and attributes.

The DTD for P4 was relatively easy to search and
interpret.

The Schema and DTD for P5 are much more difficult.

I also would suggest that you provide detailed
information about what schema validators will work,
provide detailed information on how to install and
configure them and provide information on where they
can be obtained.

Thanks

Discussion

  • Lou Burnard
    Lou Burnard
    2004-05-20

    • status: open --> closed
     
  • Lou Burnard
    Lou Burnard
    2004-05-20

    Logged In: YES
    user_id=1021146

    This comment appears to come from someone who hasn't
    actually looked at the documentation for P5, since it does
    provide exactly the kind of "tag library" feature being
    requested, as indeed did P4.

    The suggestion to provide more information on schema
    validators is an interesting one. Such info in the Guidelines
    would be out of place, because rapidly outdated; it would
    however be very useful on the TEI Software page, and we
    should not lose sight of this suggestion for that purpose.

    This being an anonymous comment, I'm not sure where it
    goes from here, so I am going to close it off.

    Lou

     
  • Lou Burnard
    Lou Burnard
    2004-09-22

    • status: closed --> wont-fix
     
  • Syd Bauman
    Syd Bauman
    2006-09-25

    • status: wont-fix --> closed