W3C home > Mailing lists > Public > public-test-infra@w3.org > July to September 2012

First draft of tutorial on testharness.js

From: Robin Berjon <robin@berjon.com>
Date: Mon, 2 Jul 2012 18:40:21 +0200
Message-Id: <D3B5D8F3-BB7B-44A4-BEFA-35C28C80D63D@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 Monday, 2 July 2012 16:40:52 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:20:33 UTC