atw: Re: Microsoft vs Apple style guides

  • From: Michael Edward Granat <megranat@xxxxxxxx>
  • To: austechwriter@xxxxxxxxxxxxx
  • Date: Mon, 08 Dec 2003 10:02:02 +1100

Come on guys, don't get yourselves in a knot about this.

It isn't that hard, just capture it as it happens.

Document the way to use the WinDoze bits step by step, like screen capture 
"postcards" - some text, then a picture of where you are, referring to the 
section where you will put the info on the Fruity PC based peripheral.

Then you hop over to your Golden Delicious, Granny Smith or Jonathan 
(depending on what colour of lollipop case it has) Fruity PC and do a 
screen capture (using the command and function keys if I remember rightly) 
postcard series on that.

It's no big deal.  Do it with pictures, use the WinDoze words for the 
WinDoze operators and use the Fruity PC words for the Fruity Folk.

You know that the full time Fruity Folk are never going to understand any 
of the terms for WinDoze.  (Hell, typically they don't even know anything 
about hard drive housekeeping!)  Trying to push terms on them that they 
don't understand will simply end in tears, smudging the pages of your 
beautifully printed manual.

Plus the WinDoze users won't have a clue about any fruity thing you're 
talking about.  "What a colour GUI with real drag and drop support and 
drives that know what's happening?  When do they think this is, 1985?".

Why make it so hard on yourself.

Just document each for each, keeping things in separate areas of your manual.

Blending windows with apples invariably becomes a sloppy pane in the glass.

Cheers,

Michael Granat
Write Ideas

**************************************************
To post a message to austechwriter, send the message to 
austechwriter@xxxxxxxxxxxxxx

To subscribe to austechwriter, send a message to 
austechwriter-request@xxxxxxxxxxxxx with "subscribe" in the Subject field.

To unsubscribe, send a message to austechwriter-request@xxxxxxxxxxxxx with 
"unsubscribe" in the Subject field.

To search the austechwriter archives, go to 
www.freelists.org/archives/austechwriter

To contact the list administrator, send a message to 
austechwriter-admins@xxxxxxxxxxxxx
**************************************************

Other related posts: