- From: Michael J McCarthy <mm6@andrew.cmu.edu>
- Date: Wed, 04 Jan 2012 19:06:30 +0000
- To: Ian Jacobs <ij@w3.org>
- Cc: site-comments@w3.org
Hello Ian, I have provided below the current and proposed paragraph. If you would like for me to submit more I would be happy to do so. Mike Current ====== 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. Suggested Edit =========== A 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 humans, to clarify the use of parameters or to specify the precise semantics of operations. On Wed, 4 Jan 2012, Ian Jacobs wrote: > > 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 19:11:39 UTC