Re: Editorial Change: links between OWL docs

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 UTC