Re: [sca-bindings] Conformace point highlight color

I have added two shades of grey (10%
and 20%) to the samples.  I agree with your point about grey working
well with color-challenged technology and people.  My only concern
about that approach is that this does not provide any real visual distinction
from samples.

In the C++ and C specs we use italics
for text literals and courier for language constructs (keywords/identifiers),
so I would not be thrilled with the font changes you suggested.

Bryan Aupperle, Ph.D.

STSM, WebSphere Enterprise Platform Software Solution Architect

Research Triangle Park,  NC 

+1 919-254-7508 (T/L 444-7508)

Internet Address: 

Anish Karmarkar <>

06/26/2009 06:47 PM

To

Bryan Aupperle/Raleigh/IBM@IBMUS

cc

, ,


Subject

Re: [sca-bindings] Conformace point
highlight color

Bryan,

Thanks for starting the thread and providing alternatives.

I actually prefer a shade of grey. Is there a good reason not to use 

grey? Works well with color-challenged technology and people. We could

even use italics in addition to the grey color. I know in some SCA specs

we have used italics (although not consistently) for attribute/element

names/values, but I would suggest changing that and using courier new 

font for those.

I would also like to start a discussion on the suggestion that Eric had

made: to use a superscript instead of running text for the conformance

item number. It does enhance the readability.

-Anish

--

Bryan Aupperle wrote:

> 

> There has been some discussion over the past few weeks about the color

> highlighting of the conformance points in several of the TCs.  To

> summarize the key points of the discussion:

> 

> - Without the highlighting, it is not clear in the PDF version of

> document what the extent of the conformance point text is (it shows
up 

> with grey shading in Word but this is not carried over to the generated

> PDF).  One of the TAB members remarked favorably on the highlighting
of 

> the Assembly spec in his review of the C++ spec.

> - The current highlight color can make the text  hard to read
in some 

> environments, especially when the highlighted content includes added

> text that is displayed in a different color.  This will not be
as big a 

> concern when we are done working on the documents, but is a problem
for 

> us in the mean time.

> - The current color is rather intense.

> 

> I have prepared a test version of the C spec, which currently does
not 

> have the highlighting, showing 6 different highlight color options
(the 

> original yellow, plus 5 others)  The best place to look at the
samples 

> is Appendix F (pages 109-112).  Here you can see the colors with
and 

> without added text in them.  I have also converted the sample
to PDF to 

> show what that would look like (links do not work).

> 

>  

> 

> I offer this up to start an e-mail discussion about what highlighting

> color people prefer.  My preference is the light yellow used
for C20006 

> and C20014.  It shows well but does not seem to clash as badly
with red 

> marking for added text.

> 

> Bryan Aupperle, Ph.D.

> STSM, WebSphere Enterprise Platform Software Solution Architect

> 

> Research Triangle Park,  NC

> +1 919-254-7508 (T/L 444-7508)

> Internet Address: 

> 

> 

> ------------------------------------------------------------------------

> 

> ---------------------------------------------------------------------

> To unsubscribe from this mail list, you must leave the OASIS TC that

> generates this mail.  Follow this link to all your TCs in OASIS
at:

> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php