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 ([email protected]) http://www.w3.org/People/Jacobs/ Tel: +1 718 260 9447
