This is an interesting posting from Charles McCathieNevile to the rdf-interest group discussing how to correctly document an RDF Schema.
- Ensure that the terms are annotated with labels and comments
- Flag annotations with their language code, and seek translations into other languages
- Use SKOS or custom properties to embed actual examples in the schema
- Publish schema and documentation at the namespace URI
Must remember to apply these to my own schema, and also see if we can get the FOAF schema similarly up to scratch.