W3C home > Mailing lists > Public > public-egov-ig@w3.org > April 2009

RE: ISSUE-36 (Daniel): Providing Documentation/Schemas/APIs [Open Government Data]

From: Owen Ambur <Owen.Ambur@verizon.net>
Date: Wed, 29 Apr 2009 10:37:57 -0400
To: "'eGovernment Interest Group WG'" <public-egov-ig@w3.org>
Message-id: <001e01c9c8d8$16ddde20$44999a60$@Ambur@verizon.net>
To the degree that XML schemas are used, this issue could be sharpened by suggesting that the definitions of each element should be documented in plain language in <xsd:documentation> elements contained within each schema.  http://www.xml.com/pub/a/2000/12/13/schemas/part2.html?page=3

The <xsd:appinfo> element can also be used, but I personally care most about the data rather than the software.

Owen

-----Original Message-----
From: public-egov-ig-request@w3.org [mailto:public-egov-ig-request@w3.org] On Behalf Of eGovernment Interest Group Issue Tracker
Sent: Wednesday, April 29, 2009 9:40 AM
To: public-egov-ig@w3.org
Subject: ISSUE-36 (Daniel): Providing Documentation/Schemas/APIs [Open Government Data]


ISSUE-36 (Daniel): Providing Documentation/Schemas/APIs [Open Government Data]

http://www.w3.org/2007/eGov/IG/track/issues/36

Raised by: Daniel Bennett
On product: Open Government Data

Change the section to Providing Documentation, Schemas and APIs

Add language to say, 
Governments should always provide full documentation to help explain data as explicitly and clearly as possible. Additionally, ....
Received on Wednesday, 29 April 2009 14:38:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 29 April 2009 14:38:58 GMT