W3C home > Mailing lists > Public > w3c-rdfcore-wg@w3.org > October 2002

RDF Core WDs document consistency items

From: Dave Beckett <dave.beckett@bristol.ac.uk>
Date: Mon, 28 Oct 2002 18:55:34 +0000
To: RDF Core <w3c-rdfcore-wg@w3.org>
Message-ID: <25516.1035831334@hoth.ilrt.bris.ac.uk>

Suggestions for things for consistency across the docs that the
Series Editor - Brian -  might want to consider:

1) The phrasing, order and titles of the documents at the start of
   all the RDF specs, usually in the Introduction section (as Frank raised).

   For example:
   which I seem to have in a random order; I can't recall how I
   picked that one.   Or in the latest primer draft:

   We really need the new model theory doc title if it is changing

   Pat: Is it something like RDF Formal Semantics: Model Theory ?

   Maybe also consider if this list should be in all documents?

2) The [RDF-SEMANTICS] reference labels to use

   In particular I'm trying to use the new title
   "RDF Vocabulary ..." [RDF-VOCABULARY] etc. rather than emphasis
   the schema word.

3) The acknowledgements section with respect to current/former WG members.

   I offer my shorter version of the concepts doc section (last two


More trivially:

4) Example code block styles
   I think primer and syntax are mostly in alignment here since they
   we use the same style.  I tend to give each one a label, link to
   it and have files that can be clicked / downloaded / validated
   particularly for complete examples.

5) Figure colo(u)r schemes

   If we cared, so that the nodes and arcs were similar.  However
   Pat's pictures are so pretty, I don't want him to change them ;)

   I had a comment that the black-on-red nodes I used was bad
   contrast and a bit difficult to read, especially when printed.
   Maybe the black-on-green nodes also has this problem?


Received on Monday, 28 October 2002 13:57:31 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 20:24:16 UTC