Spencer requested yesterday that I send out a message with how I think we are
proceedign withthe documentation. We'll see if this matches up with Spencer's
understanding.
We are committed to document the ontology, the MRL syntax and semantics, the
MTF syntax (the MTF semantics is the ontology).
- Kurt is documenting the MRL syntax and semantics. THis documentation will
be written in HTML 2.0.
- I don't know who is documenting the MTF syntax, but I think Kurt should be
doing this, because he understands it the best. This documentation should
have a high level view of the syntax (ie, what is it for) and a reference
description of what all the syntactic elements do (what are tags, how do I
express them, what are they good for). Also HTML 2.0.
- Ontology:
-- Big picture (organization of the model(s)). HTML 2.0. Who is doing this?
-- Reference section
--- Application (Kurt/Noi/Pedro: Kurt is probably overloaded at this point)
--- Task (Noi)
--- Presentation (Pedro)
THe reference section or each sub-model consists of two parts. An introduction
section written in HTML 2.0, and a detailed reference section that is
automatically generated from the MRL (actually from the internal MRL objects).
Pedro will work on the HTML generator.
A good example of what I have in mind is in
http://www-ksl.stanford.edu/knowledge-sharing/ontologies/html/bibliographic-dat
a.text.html
Also take a look at
http://www-ksl.stanford.edu/knowledge-sharing/ontologies/html/mechanical-compon
ents/index.html
and in general start from
http://www-ksl.stanford.edu/knowledge-sharing/ontologies/index.html
Pedro Szekely
USC/ISI, 4676 Admiralty Way, Marina del Rey, CA 90292
Phone: 310/822-1511, Fax: 310/823-6714
URL: http://www.isi.edu/isd/szekely.html