Re: css3 line-break tests

Le Mar 22 janvier 2013 1:33, Glenn Adams a écrit :
> On Mon, Jan 21, 2013 at 9:36 PM, "Gérard Talbot"
> <css21testsuite@gtalbot.org
>> wrote:
>
>>
>> Le Lun 21 janvier 2013 21:28, Glenn Adams a écrit :
>> > FYI, I intend to submit a number of tests related to the CSS3
>> line-break
>> > property, particularly those that relate to testing the
>> functionality or
>> > fixes deriving from:
>> >
>> > [1] https://bugs.webkit.org/show_bug.cgi?id=89235
>> > [2] https://bugs.webkit.org/show_bug.cgi?id=105692
>> >
>> > Some preliminary reftests have already been included in [3], but
>> need to
>> > be
>> > finalized and retargeted for the CSS test suite format.
>> >
>> > [3]
>> https://bugs.webkit.org/attachment.cgi?id=172397&action=prettypatch
>> >
>> > Regards,
>> > Glenn
>>
>> Glenn,
>>
>> I suggest to make single, unique tests and not a test made of 3 single
>> tests.
>>
>> Avoid using the word "box" in the description; for most people, a box
>> is
>> a 3-dimension object.
>>
>> If you refer to identical rendering, then shape and size of rectangle
>> should be identical and content of rectangle should be identical.
>>
>> From bug report https://bugs.webkit.org/show_bug.cgi?id=105692
>>
>> Test:
>> https://bug-105692-attachments.webkit.org/attachment.cgi?id=180625
>>
>> Expected result:
>> https://bug-105692-attachments.webkit.org/attachment.cgi?id=182513
>>
>> is not what I would have understood or expected by 3 identical pairs
>> of
>> boxes.
>>
>
> Thanks for that input. Regarding the term 'box', I disagree with you
> that
> it should be avoided. The term has a well defined meaning in CSS [1]
> that
> is not a 3 dimensional object. We can't very well and go retrofit the
> fundamental CSS concepts here, I'm sure you'll agree.
>
> [1] http://www.w3.org/TR/CSS2/box.html


It is a well defined term in CSS. But going through all the tests should
be doable by anyone: your friend, your mailman, your pastry cook, your
butcher, your neighbour. Outside CSS, a box is definitely a 3-dimension
object. Therefore, the pass/fail condition sentence of all tests should
try to avoid all HTML and CSS related vocabulary and terminology.

"
That self-describing test instructions are accurate, precise, simple,
and self-explanatory. Your mother/husband/roommate/brother/bus driver
should be able to say whether the test passed or failed within a few
seconds, and not need to spend several minutes thinking or asking
questions.
"
http://wiki.csswg.org/test/css2.1/review-checklist#test-design

There are tests which are saying:
- "there should be a 100x100 green block": your mother would certainly
ask "what's a 100x100 block and how can I measure it"? Some people will
even wonder if there is math multiplication involved here.
- http://test.csswg.org/suites/css2.1/20110323/html4/c527-font-000.htm
Your bread baker would certainly ask "What's 13px and how big is it?
What's Helvetica anyway?"
- http://test.csswg.org/suites/css2.1/20110323/html4/c531-color-000.htm
and
http://test.csswg.org/suites/css2.1/20110323/html4/c532-bgcolor-000.htm
"what's the meaning of 'line' in your tests?" would probably be asking a
few of your friends.
-
http://test.csswg.org/suites/css2.1/20110323/html4/background-image-cover-001.htm
"What's a 'box' exactly in those tests" would probably be asking others
- etc.

I personally have neighbour-friends who are retired and never ever used
a computer and they couldn't understand/figure out some tests.

Ideally, you want the pass/fail conditions sentence to be short, clear
and understandable by non-web-people.

Gérard
-- 
Contributions to the CSS 2.1 test suite:
http://www.gtalbot.org/BrowserBugsSection/css21testsuite/

CSS 2.1 Test suite RC6, March 23rd 2011:
http://test.csswg.org/suites/css2.1/20110323/html4/toc.html

CSS 2.1 test suite harness:
http://test.csswg.org/harness/

Contributing to to CSS 2.1 test suite:
http://www.gtalbot.org/BrowserBugsSection/css21testsuite/web-authors-contributions-css21-testsuite.html

Received on Tuesday, 22 January 2013 08:09:54 UTC