This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
The various "APIs" to the Validator needs sample code to demonstrate how to use them. SOmething in the vein of the Perl snippet in the URL but for multiple languages, platforms, and environments.
Retargetting 0.7.0 (by which time it may be mooted by SOAP).
Retargetting for 1.0; ain't gonna happen for 0.7 (and neither is SOAP).
I think http://validator.w3.org/docs/api.html covers this. So does http://validator.localhost/docs/users.html#Output to some extent. closing.
There's not a single line of code in the API docs referenced. -> Reopening.
(In reply to comment #4) > There's not a single line of code in the API docs referenced. Then I disagree code samples are necessary. I'd rather we encouraged building libraries (see e.g http://www.w3.org/QA/2006/10/validator_api.html on the QA weblog), and link to these libraries.
(In reply to comment #5) > Then I disagree code samples are necessary. I'd rather we encouraged building > libraries [] The relationship between those options is not "either or" but "and"; code samples are a good way to encourage building libraries.
(In reply to comment #4) > There's not a single line of code in the API docs referenced. -> Reopening. > If code is provided to interact with the API, the W3 would need to maintain their own library to interact with the API. I think this is unnecessary at the moment and we should just link to API libraries which have code samples and documentation. I feel that the W3 has fulfilled enough of an obligation by providing the SOAP output without causing additional coding support. The other alternative is to make an official API library supported by the W3, but this would add non-core burden on the validator team (there are already libraries which are in the wild and supported externally). A library which does have documentation and code samples is available at pear.php.net which could be link in the libraries references which may fulfill some of this bug. Link to library homepage: http://pear.php.net/package/Services_W3C_HTMLValidator API and methods available for the library: http://pear.php.net/package/Services_W3C_HTMLValidator/docs/latest/Services_W3C_HTMLValidator/Services_W3C_HTMLValidator.html API interaction example: http://pear.php.net/manual/en/package.webservices.services-w3c-htmlvalidator.examples.php
Just added a link to the PEAR library into the API documentation. As for whether to give actual code bits to access the API, I have to admit: * I 've never see it done (checked a number of APIs like flickr, they all detail their API and give a list of libraries that bind to it) * I don't know how to do it without actually writing a library and showing the code, which I believe would be too verbose for the documentation. given the above, and although I do understand Terje's points, I'm closing as WORKSFORME.