W3C home > Mailing lists > Public > site-comments@w3.org > January 2012

Re: Text poorly written

From: Ian Jacobs <ij@w3.org>
Date: Wed, 4 Jan 2012 12:23:33 -0600
Cc: site-comments@w3.org
Message-Id: <5C44C3AC-A6CA-4B08-B51D-50B8E96B7D2A@w3.org>
To: Michael J McCarthy <mm6@andrew.cmu.edu>

On 4 Jan 2012, at 12:10 PM, Michael J McCarthy wrote:

> 
> Dear W3C,
> 
>    I am a fan of W3C and was just wondering why we have such
> a poorly written web site.
> 
> 
>    For example, under Service Descriptions, we have:
> 
> Service Description is an important part of accessing a service. Most service description languages are targeted at machine consumption, allowing the automatic creation of code skeletons, search and classification of services, but it can be consumed by human, to clarify the use of some parameters or the semantic of operations performed.
> 
>   I think that paragraph is almost impossible to read. There are
> many paragraphs just like the above.
> 
>   Do you need a volunteer to write these descriptions in a more
> clear and consise way? If so, let me know.

Hi Michael,

I believe this is the URI you are referring to:
 http://www.w3.org/standards/webofservices/description

I welcome your suggested edits!

Ian

> 
> Mike McCarthy
> Associate Teaching Professor of Information Systems
> Heinz College
> 
> Carnegie Mellon
> 
> 
> 
> 

--
Ian Jacobs (ij@w3.org)    http://www.w3.org/People/Jacobs/
Tel:                                      +1 718 260 9447
Received on Wednesday, 4 January 2012 18:23:37 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 24 October 2012 16:21:34 GMT