The following are a few issues not directly related to simple
documentation/schema errata/issues for the wiki but which I think should
or could be addressed.
1) The webpage at http://www.loc.gov/standards/mets/mets-schemadocs.html
refers to "METS Schema Change Requests" at the bottom, but it is a
.. It should instead should apparently be linking to
2) The schema at http://www.loc.gov/standards/mets/mets.xsd has
smLocatorLink and smArcLink but they are not mentioned in the docs.
3) I think the docs should indicate xlink:type is required for those not
depending on external DTDs to supply the information (since the XLink
schema you reference mentions it as FIXED on each type), unless you are
planning to move to XLink 1.1 which drops the requirement for using
xlink:type in the case of simple links:
4) Have you considered creating the documentation in some XML format
(like TEI) and then put it online and in version control (or even a
wiki?). There are already tools to transform these to PDF, and besides
offering versioning and the ability for direct editing and suggestions,
the files could also be translated to HTML (for nice access to those who
(strongly!) prefer HTML for online viewing) and there would be an
unambiguous version as far as avoiding things like the PDF obscuring
images. It would also allow you easier maintenance of attribute
descriptions which do not vary across elements, and the ability to
automate other reference information out of the documentation like you
do for the schema.