W3C home > Mailing lists > Public > www-webont-wg@w3.org > June 2003

Re: Editorial Change: links between OWL docs

From: Guus Schreiber <schreiber@cs.vu.nl>
Date: Thu, 19 Jun 2003 13:34:42 +0200
Message-ID: <3EF19FD2.3010100@cs.vu.nl>
To: Sandro Hawke <sandro@w3.org>
CC: www-webont-wg@w3.org

Will add this point to today's editor's meeting agenda.
Guus


Sandro Hawke wrote:

> 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] http://www.w3.org/TR/owl-features/#s1.1 
>     editors: http://www.cs.vu.nl/~frankh/spool/OWLOverview.htm
> 

-- 
Free University Amsterdam, Computer Science
De Boelelaan 1081a, 1081 HV Amsterdam, The Netherlands
Tel: +31 20 444 7739/7718
E-mail: schreiber@cs.vu.nl
Home page: http://www.cs.vu.nl/~guus/
Received on Thursday, 19 June 2003 07:34:43 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:58:01 GMT