sca-bindings message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: Re: [sca-bindings] Conformace point highlight color
- From: Bryan Aupperle <aupperle@us.ibm.com>
- To: sca-assembly@lists.oasis-open.org, sca-bindings@lists.oasis-open.org, sca-c-cpp@lists.oasis-open.org
- Date: Wed, 1 Jul 2009 06:03:29 -0600
I should not do these things late in
the day...
Here are the attachments
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
Simon Nash <oasis@cjnash.com>
07/01/2009 07:17 AM
|
To
| Bryan Aupperle/Raleigh/IBM@IBMUS
|
cc
| sca-assembly@lists.oasis-open.org, sca-bindings@lists.oasis-open.org
|
Subject
| Re: [sca-bindings] Conformace point
highlight color |
|
Bryan,
Where is the sample with the two shades of grey?
Simon
Bryan Aupperle wrote:
>
> 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
>
sca-ccni-1.1-spec-cd03-rev2-test.doc
sca-ccni-1.1-spec-cd03-rev2-test.pdf
sca-ccni-1.1-spec-cd03-rev2-test-Final.pdf
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]