OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-c-cpp message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: 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: aupperle@us.ibm.com



Anish Karmarkar <Anish.Karmarkar@oracle.com>

06/26/2009 06:47 PM

To
Bryan Aupperle/Raleigh/IBM@IBMUS
cc
sca-assembly@lists.oasis-open.org, sca-bindings@lists.oasis-open.org, sca-c-cpp@lists.oasis-open.org
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: aupperle@us.ibm.com
>
>
> ------------------------------------------------------------------------
>
> ---------------------------------------------------------------------
> 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



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]