Hi,
Regina Henschel wrote:
Martina Waller schrieb:
My first approach was to look into the inconsistencies of the current
help style. "colon" is mentioned in the other places because currently
we have several cases where the "Syntax" and "Example" headings as
well as the arguments are followed by a colon. That should change for
reasons of consistency.
Martina, then just change it :-)
I have looked at the changes and found
no quotes, except if they are literal
=DATE(00;1;31) yields 1/31/00 if the cell format setting is "MM/DD/YY"
That's such a point which shows the difficulties (and where my
"MM/DD/YY" was bad). If you use quotes in normal texts everyone will
understand it. But when mixed with syntax descriptions they are
dangerous. For example in cell format codes you can also use quotes to
include a text in the format, like
"€ "0.00
I put it here on a new line to separate it from the text. The style
guide must include a rule how to cite settings and other formal things,
without using quotes. Are accessibility tools able to evaluate tags in
the produced HTML code? In that case I suggest to use one of the HTML
elements. HTML tag <q> or <samp> or <code> might be suitable. Such
element can be bind to a style via css, which gives the element another
text color or text style or font or background color or what you like to
distinguish it from text. With such tags you can use different styles
for normal and for high contrast.
we should be able to write with style. Whenever we need a direct
quotation within the text, we should apply a style (in Writer) or a tag
(in XML) to that text.
Workarounds like the following should be banned from the help:
Enter "ABC" (without the quotes) ...
Instead, the string to enter should be tagged in a way that survives all
subsequent transformations. Readers must be able to see that the ABC has
a special meaning, no matter if they read it in the help viewer, in a
PDF, or using any translation tool.
The currently used authoring environments fully support these tags. I'm
not so sure about the currently used translation tools.
Uwe
--
[EMAIL PROTECTED] - Technical Writer
StarOffice - Sun Microsystems, Inc. - Hamburg, Germany
http://wiki.services.openoffice.org/wiki/Documentation
http://user.services.openoffice.org/en/forum
http://blogs.sun.com/oootnt
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
