TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
> From: louise -dot- r -dot- stevanovic -at- transport -dot- qld -dot- gov -dot- au
> I'd be interested to hear how those of you who never use
> 'you' would reword
> sentences that provide options, reminders or information rather than
> imperatives, such as the following:
I wanna play.
> You will be prompted to update the document history
> whenever you
> save the document as a new version.
"There is a prompt to update the document history with each save as a new
version."
"There is a prompt..." can be replaced with "Software X prompts..."
> The IMD toolbar is displayed in the bottom left of
> the screen. You
> can move it anywhere on the screen.
"The IMD toolbar is displayed in the bottom left of the screen and it can be
moved anywhere on the screen."
Or "...and is movable anywhere..." for a slightly awkward avoidance of "can
be," which may seem passive.
> If you insert captions, remember to update the lists
> under the
> Figures and Tables headings.
"Update [Tables of Figures for Figures and Tables] after inserting
captions."
Word calls those lists Tables of Figures, but I don't know if people think
of them that way. Personally, I would say, "Select all content (Ctrl+A) and
update (press F9) all fields after adding captions." Users don't need to
select all content to update only the tables, but usually other things get
changed so everything should be updated and it needs to be updated twice
when page numbering changes after the first update.
> The last paragraph mark contains formatting for that
> document, so
> if you copy it, it can overwrite the formatting in
> the document
> you paste into.
"Copying the last paragraph mark in one document and pasting it into another
document will overwrite the formatting in that document."
Is that "will" or "can"? I imagine that "that document" can be replaced
with "the second document" or "the receiving document" if "that" is somehow
undesirable. Although, "the receiving document" sounds a little odd.
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
