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

Re: First draft of tutorial on testharness.js

From: Boaz Sender <boaz@bocoup.com>
Date: Tue, 3 Jul 2012 10:05:23 -0400
Message-ID: <CAHx3KhcvEUAwpc-QjrXR_KSUQVjNCHvThfXnL8EUELrdO39jyQ@mail.gmail.com>
To: Robin Berjon <robin@berjon.com>
Cc: "<public-test-infra@w3.org>" <public-test-infra@w3.org>
Hey Robin,
This is a great first step!

I think that navigation based on all the public interfaces, with short
descriptions and signatures for each interface,  could really help make
these docs more approachable.

All the information is there, I just think reorganizing it in this way
could help.

Excited to see progress on this!

Boaz Sender

On Mon, Jul 2, 2012 at 12:40 PM, Robin Berjon <robin@berjon.com> wrote:

> 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 14:06:22 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:34:08 UTC