Editorial Change: links between OWL docs

• From: Sandro Hawke <sandro@w3.org>
• Date: Thu, 19 Jun 2003 07:16:04 -0400
• To: www-webont-wg@w3.org
• Message-Id: <200306191116.h5JBG4Se016132@roke.hawke.org>

I'd like to suggest an editorial change to all OWL documents: I think
each document should make it clear to a reader where they are in the
family of the six WebOnt documents.  I suggest some text in both the
abstract and early in the introduction like:
    "This is one part of the specification of OWL, the Web Ontology
    Language.  [OWL Overview] describes each of the different parts
    and how they fit together; this part is ... (addressing
    normativity) ... "
In particular, someone picking up or following a link to any document
should be able to find all of them.  Even the editor's draft of S&AS
only mentions Overview (and does so as "Features") in the list of
references, and I can't find any path from S&AS to Test.  The
"document roadmap" in Overview never mentions Test either.  I think I
see the historical reasons for this, but can we correct it?  In
particular, editors of each document should probably make sure they
are happy with how their document is described in the roadmap [1].
I think this tripped up the QA reviewers, and I can't see why it won't
trip up many other readers.  Our Last Call commenters were generally
not confused by this, but the Last Call email specifically listed the
then-five drafts.
     -- sandro
[1] https://www.w3.org/TR/owl-features/#s1.1 
    editors: https://www.cs.vu.nl/~frankh/spool/OWLOverview.htm

Received on Thursday, 19 June 2003 07:16:05 UTC