When changing the various styles while the edit recording function is in
force, the term /Formats /usually appears in the change log. (One
exception is that changing to the default formatting does not.) Whenever
I insert styles in a previously unstyled document while doing technical
editing elsewhere and I see that /Formats /term in the changes later
while editing, I will often commit those "errors"--the ones showing as
/Formats/--while leaving the other substantive edits intact for the
author's and others' peer-review process afterwards. Removing empty
"paragraphs" will show up as /Deletions/. These edits can be accepted
too without adversely affecting the meat in the changes log, as long as
the editor has the authority or permissions to do so (depends on the
situation and what is expected of the technical editor).
Editors have their own ways of doing things. And after doing things for
a while, you will adopt whatever that saves time (and money for the
clients) while leaving the major, substantive editing intact--the major
task for a technical editor. A good technical editor can often do the
tasks of both copyeditors and proofreaders (and often does much of both
out of necessity today).
Because others are going to use the editor's redlining, it is a good
practice to include a legend or some examples of just whatever color or
font effects the redlining attributes have so that the clients or peer
reviewers know what to look for.
Gary
T. J. Frazier wrote:
New versions of the template, template how-to, and Writing OO Guides
have been proofed for "Tip" capitalization, plus minor proofreading,
and uploaded. I believe that this completes the cleanup of our
"internal" documents. Writers' Guide chapters forthcoming, slowly.
Lessons learned: when changing formatting, it is probably wise to
change the setting of Tools > Options > Writer > Changes Change
Attributes list box. By default, it adds bolding to the changed area;
if you're changing font attributes, this can be very confusing. I
selected "background color", but other choices (like double-underline)
are also easier to work with. This might be worth a tip somewhere in
the OOWG.
Query: is there a use for the three old (pre-publication) versions of
documents that were already in the Contributor Resources Feedback
folder? If not, could somebody remove them?
Jean Hollis Weber wrote:
TJ and Gary,
The words "Tip", "Note" and "Caution" should have the paragraph style
"OOoTip/Note/Caution". This paragraph style has existed in the
template for some time and is applied to the Tip/Note/Caution
paragraphs in the template.
Quite right (I was wrong). No action was required beyond changing the
actual capitalization.
snip
Thanks to both Gary and TJ for their work on this chapter.
TJ, thank you for your offer to clean up the other chapters. I accept
with enthusiasm!
I plan to let these chapters straggle in over several weeks. By all
means let me know if you need them faster. The actual cap change is
one Find & Replace operation, so I can turn them around very quickly,
at need. /tj
--Jean
Gary Schnabl wrote:
Be advised that the three OOoAuthors "notes" in the "template" are
1-row, 2-column tables. Table text can carry its own formatting
styles. In the last edit, when I overwrote those several instances
of "IP" in "TIP" with "ip", the formatted style should not have
changed. It should still be the same table text style that was
previously used. Pardon my ignorance about this, but without my
checking again, I am not sure just what particular styles are used
for the body text in the "notes".
Whoever proofs the recent edits can commit whatever edits that seem
appropriate in preparation for its being republished. Also delete
the inappropriate graphic in the section concerning the ruler
because it doesn't reflect reality. A correct graphic can be added
later.
However, do these on a different file that I will upload in a bit
because there are two cases whose character styles I missed
applying and there is a typo in a comment note (no biggie, I guess...).
Gary
T. J. Frazier wrote:
Jean and Gary,
I will volunteer to do some or all of the cleanup involved (as
previously outlined), if you like. I rather enjoy wielding a
dustpan and broom, and you two can spend your time doing things I
can't do (yet or ever). /tj
Jean Hollis Weber wrote:
I have been intending for some time to change "TIP" to "Tip"
everywhere in the books, so I'm glad TJ brought this up. The
inconsistencies he noted are almost surely due to me changing this
in some places but not in all, and not in the template.
Gary, I encourage you to change the template. Then as the chapters
get revised for other reasons, we can progressingly change them to
suit.
Regards, Jean
Gary Schnabl wrote:
Changing "TIP" to "Tip" puts that "note" in line with the other
two in that all three will then be using the same font effect,
instead of "TIP" being the "lone man out" in All-Caps. Besides,
OOoAuthors uses "sentence" style capitalization for headings and
such, instead of the "headline" style used in the documentation
of some others. Having "Tip" is also more in line with that concept.
Notice that the latest edit of Chapter 3 is not published yet. So
this edit was a trial balloon for this anticipated change. If
adopted, all that is needed is a simple change in the
"template"for future work and a simple change for the older
versions.
Gary
T. J. Frazier wrote:
Gary Schnabl wrote:
Chapter 3 of the Writer Guide was proofread on 15 Dec 2006 with
some subsequent edits (1 Jan 2007). (snip)
My thanks to Gary for showing a newbie, by example, how to do it.
Working with Text - WG Chapter 3
<http://oooauthors.org/en/authors/userguide2/writer/feedback/0203WG-WorkingwithText_15Dec06_JHW_TJ_GS.odt/file_view?portal_status_message=File%20changes%20saved.>
(snip)
There is a string of problems associated with the capitalization
change
of the tip feature, from "TIP" to "Tip".
1) The source of the problem is the chapter template, which
shows "TIP"
in the "things to be copied" section. This needs changing. The
"Template How-to" should reflect this change, as well.
2) The recommended procedure is to copy these examples into the
AutoText
mechanism. That means that current authors must be warned to
re-copy
the corrected examples.
The following Item #3 is just plain wrong. Sorry. /tj
3) The bold formatting in the template (for tip, note, and
caution) is
locally applied. This is probably a bad example for our
authors. The
OOoStrongEmphasis style can't be used, because of the different
font
specifications. I suggest that we need another character style for
this. (What we actually need is an option to "use existing
font" on the
Font page of the Character Style dialog, so that the style only
applies
the font effect; but that's a code matter.)
If we decide to change "TIP" to "Tip", I will include that in my
on-going proof-reading of the published chapters. /tj
--
TJFrazier
