[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
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 >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]