W3C home > Mailing lists > Public > public-wai-ert@w3.org > January 2007

[comment HTTP in RDF ] General comment, Syntax, Typos

From: Karl Dubost <karl@w3.org>
Date: Wed, 17 Jan 2007 03:08:23 -0000
To: public-wai-ert@w3.org
Message-Id: <20070117030857.9174B4F1F1@homer.w3.org>

Hi,
This is a comment about 
http://www.w3.org/TR/2006/WD-HTTP-in-RDF-20061220/

# Introduction

In introduction, Avoid as much as possible form of the type "This document presents", talk about the subject right away. For example,

    "HTTP Vocabulary in RDF" is a representation of …

# typos

s/not inteded/not intended/

# references

Do not use references as direct names for the resources, you are pointing to. Instead of 

    refer to [RDF] or [RDF-PRIMER] for this purpose.

prefer

    refer to Resource Description Framework (RDF): Concepts and Abstract Syntax [RDF] or  RDF Primer [RDF-PRIMER] for this purpose.

You can even put a direct link in the form of

    <cite><a href="http://www.w3.org/TR/rdf-concepts/">Resource Description Framework (RDF): Concepts and Abstract Syntax</a></cite> [<a href="#ref-rdf">RDF</a>]
    
That way, you maximize the usability of the document.

# Table of contents

The table of contents under 3. is not right

  3 Header Extensions (RFC 4229)
    * 2.1. Request Extensions
    * 2.2. Response Extensions
    * 2.3. Unbound Extensions





Title: "HTTP Vocabulary in RDF"
URL: http://www.w3.org/TR/2006/WD-HTTP-in-RDF-20061220/
Date: 2007-01-17
Status: 1st WD

-- 
Karl Dubost - http://www.w3.org/People/karl/
W3C Conformance Manager, QA Activity Lead
   QA Weblog - http://www.w3.org/QA/
      *** Be Strict To Be Cool ***
Received on Wednesday, 17 January 2007 03:09:09 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:18:27 GMT