Fwd: First draft of tutorial on testharness.js

[ Bcc'ing public-webevents since testharness.js is a mandatory 
requirement for Web Events' test cases ... ]

FYI, a really nice testharness.js tutorial 
<http://darobin.github.com/test-harness-tutorial/docs/using-testharness.html> 
from Robin.

Thanks Robin!

-------- Original Message --------
Subject: 	First draft of tutorial on testharness.js
Resent-Date: 	Mon, 2 Jul 2012 16:40:53 +0000
Resent-From: 	<public-test-infra@w3.org>
Date: 	Mon, 2 Jul 2012 18:40:21 +0200
From: 	ext Robin Berjon <robin@berjon.com>
To: 	<public-test-infra@w3.org> <public-test-infra@w3.org>



Hi all,

as discussed before, I've received a fair bit of feedback (notably in CoreMob) from people who seem to find that testharness.js is not as easy to pick up as they would like to. One thing that has repeatedly been said is, for better or for worse, that nowadays people like shiny HTML docs and won't find (or won't be comfortable with) the comments at the top of a lib (as is currently done).

I don't claim that this is necessarily a good thing, but I've tried to help anyway ;-)

I've now made a first pass at a tutorial for testharness.js:

     http://darobin.github.com/test-harness-tutorial/docs/using-testharness.html

It covers all that the documentation does in more detail, and with code examples side by side with the text, in a way that is shamelessly stolen from how Jasmine does it. It's also self-runnable so that test results for the example code show up at the end.

Feedback on this is very much welcome. If people like it, I'm more than happy to host it somewhere on w3c-test.org. I can also fold it into the testharness.js repository itself if desired. It's written using Docco (and Grunt).

After I've gathered some feedback here I'll post it to CoreMob to see what people there say.

-- 
Robin Berjon - http://berjon.com/ - @robinberjon

Received on Tuesday, 3 July 2012 12:37:00 UTC