Marking up assertions in our documents

Some time ago, we adopted a convention of marking up assertions so they 
could be readily identified.  When we did that, I (stupidly) introduced 
some css styles to highlight the assertions.  I purposely made these 
styles obnoxious so that someone would complain and fix them.  I also 
neglected to ever explain the convention anywhere.  Then I forgot all 
about it.

Roland has pointed out to me that our documents have obnoxious orange 
highlights in them, which he thought were diff marks.  Nope - 
assertions.  Not defined nor described anywhere.  I propose we do one of 
the following:

1) Get someone who knows what they are doing to design new styles for 
our assertions, or

2) Remove the styles altogether since they do not currently add any 
value, or

3) Document the convention in the overview of each spec so people know 
what we are trying to accomplish.

See, for example, http://www.w3.org/MarkUp/2007/ED-xhtml-access-20071030/


-- 
Shane P. McCarron                          Phone: +1 763 786-8160 x120
Managing Director                            Fax: +1 763 786-8180
ApTest Minnesota                            Inet: shane@aptest.com

Received on Wednesday, 14 November 2007 16:26:40 UTC