RE: Remote Desktop and FrameMaker

2009-09-11 Thread Reid Gray
I regularly use Frame remotely from various platforms with decent results. Application-wise it is pretty solid. Mostly, I use it over a local area network or across two centrally located LANs with one switch between them. How many 'hops' you have in between your desktop and remote machine,

Remote Desktop and FrameMaker

2009-09-11 Thread Reid Gray
I regularly use Frame remotely from various platforms with decent results. Application-wise it is pretty solid. Mostly, I use it over a local area network or across two centrally located LANs with one switch between them. How many 'hops' you have in between your desktop and remote machine,

RE: [Free Framers] Search produces five identical listings

2009-08-06 Thread Reid Gray
writes the script gives you a switch to turn it on or off so you can check the query results in both cases to see if it is working to your satisfaction. Cheers, Reid From: Nancy Allison [mailto:nancy.allis...@verizon.net] Sent: Wed 7/29/2009 8:32 AM To: Reid Gray

[Free Framers] Search produces five identical listings

2009-08-06 Thread Reid Gray
er writes the script gives you a switch to turn it on or off so you can check the query results in both cases to see if it is working to your satisfaction. Cheers, Reid From: Nancy Allison [mailto:nancy.allis...@verizon.net] Sent: Wed 7/29/2009 8:32 AM To

[OT] API technical writer list?

2009-07-23 Thread Reid Gray
Hi Framers, I was wondering if there were any lists around for API technical writers? LinkedIn groups? Thanks, Reid ___ You are currently subscribed to Framers as arch...@mail-archive.com. Send list messages to fram...@lists.frameusers.com.

[OT] API technical writer list?

2009-07-23 Thread Reid Gray
Hi Framers, I was wondering if there were any lists around for API technical writers? LinkedIn groups? Thanks, Reid

RE: Standard font for technical documentation

2009-07-20 Thread Reid Gray
For printed books the prevailing wisdom and studies show that serif font is easier to read. On the other hand, for display devices (electronic viewing) the prevailing studies and wisdom say that non-serif font is easier for humans to decode. Look at the books on your shelf. Check how many of

Standard font for technical documentation

2009-07-20 Thread Reid Gray
For printed books the prevailing wisdom and studies show that serif font is easier to read. On the other hand, for display devices (electronic viewing) the prevailing studies and wisdom say that non-serif font is easier for humans to decode. Look at the books on your shelf. Check how many of

RE: Heading levels in a UG

2009-07-15 Thread Reid Gray
Hi Framers, In general if your heading levels descend below three or four in user documentation, you need to take a step back, analyze, and rebalance. Nothing new here, just the old axiom be nice to your user... You can apply the same principle to the navigation over enterprise websites.

Heading levels in a UG

2009-07-15 Thread Reid Gray
Hi Framers, In general if your heading levels descend below three or four in user documentation, you need to take a step back, analyze, and rebalance. Nothing new here, just the old axiom "be nice to your user..." You can apply the same principle to the navigation over enterprise websites.

RE: Use of please in technical documentation and messages on screen

2009-06-26 Thread Reid Gray
For status messages such as the one you cite below, I think using please is perfectly okay. I also agree with omitting words that add nothing to the meaning of the sentence; however, the use of please can convey a specific and useful tone. It's not inappropriate for a status or feedback

Use of "please" in technical documentation and messages on screen

2009-06-26 Thread Reid Gray
For status messages such as the one you cite below, I think using "please" is perfectly okay. I also agree with omitting words that add nothing to the meaning of the sentence; however, the use of "please" can convey a specific and useful tone. It's not inappropriate for a status or

RE: Developer documentation

2009-06-25 Thread Reid Gray
This builds on the comments by Chris. You definitely need: -- - Pre-requisites for the software - Unpacking the software - Architecture diagram. (Typically in an overview section) The architecture diagram identifies where the custom application these developers

Developer documentation

2009-06-25 Thread Reid Gray
This builds on the comments by Chris. You definitely need: -- - Pre-requisites for the software - Unpacking the software - Architecture diagram. (Typically in an overview section) The architecture diagram identifies where the custom application these developers will

RE: Procedure How to Write a Manual!

2009-05-26 Thread Reid Gray
speak to their audience. Andy ak...@jaspersoft.com Date: Wed, 20 May 2009 14:51:39 -0400 From: Reid Gray rg...@interactivesupercomputing.com Subject: RE: Procedure How to Write a Manual! I think the list agrees that not just anybody can write a good manual. And No, writers cannot be just

Procedure How to Write a Manual!

2009-05-26 Thread Reid Gray
whatever words speak to their audience. Andy akass at jaspersoft.com > Date: Wed, 20 May 2009 14:51:39 -0400 > From: "Reid Gray" > Subject: RE: Procedure How to Write a Manual! > > I think the list agrees that not just anybody can write a > good manual. And "No

RE: Procedure How to Write a Manual!

2009-05-20 Thread Reid Gray
I think the list agrees that not just anybody can write a good manual. And No, writers cannot be just anybody. They must be committed, they need to love language, and as Annie Dillard says ...you really need to like words...words such as 'transmogrify' Or, if you will extend the metaphor

Procedure How to Write a Manual!

2009-05-20 Thread Reid Gray
I think the list agrees that not just anybody can write a good manual. And "No," writers cannot be just "anybody." They must be committed, they need to love language, and as Annie Dillard says "...you really need to like words...words such as 'transmogrify'" Or, if you will extend the

RE: Today's exercise in misunderstanding English

2009-04-24 Thread Reid Gray
Chicago, eh? Be put in a cauldron of lead and usurer's grease, amongst a whole million of cutpurses, and there boil like a gammon of bacon that will never be enough. The Earl of Oxford was a Celtics fan. Your turn. http://www.pangloss.com/seidel/Shaker/index.html :-b Reid

Today's exercise in misunderstanding English

2009-04-24 Thread Reid Gray
Chicago, eh? "Be put in a cauldron of lead and usurer's grease, amongst a whole million of cutpurses, and there boil like a gammon of bacon that will never be enough." The Earl of Oxford was a Celtics fan. Your turn. http://www.pangloss.com/seidel/Shaker/index.html :-b Reid

RE: Technical Writing Certificate

2009-04-08 Thread Reid Gray
Kelly's post was a real motivator. Terrific information. I hope somebody is tabulating it! How about professional writing programs? That might be useful information as well. Reid From: framers-boun...@lists.frameusers.com on behalf of Karen L. Zorn

Technical Writing Certificate

2009-04-08 Thread Reid Gray
Kelly's post was a real motivator. Terrific information. I hope somebody is tabulating it! How about professional writing programs? That might be useful information as well. Reid From: framers-boun...@lists.frameusers.com on behalf of Karen L. Zorn Sent:

RE: PDF create with FMbatch fails --doh!

2009-04-02 Thread Reid Gray
/2009 10:46 AM To: Reid Gray; framers@lists.frameusers.com Subject: Re: PDF create with FMbatch fails --doh! Reid, You wrote: We build our books here with FMbatch on a --you guessed it-- Solaris machine. We check them out of source control and build them automagically, but as you can see from

PDF create with FMbatch fails --doh!

2009-04-01 Thread Reid Gray
10:46 AM To: Reid Gray; framers at lists.frameusers.com Subject: Re: PDF create with FMbatch fails --doh! Reid, You wrote: >We build our books here with FMbatch on a --you guessed it-- Solaris machine. > >We check them out of source control and build them automagically, but as >

PDF create with FMbatch fails --doh!

2009-03-31 Thread Reid Gray
Hello Framers, We build our books here with FMbatch on a --you guessed it-- Solaris machine. We check them out of source control and build them automagically, but as you can see from the noise below a book I just created from scratch on my Windows machine is not playing nice with FMbatch.

PDF create with FMbatch fails --doh!

2009-03-30 Thread Reid Gray
Hello Framers, We build our books here with FMbatch on a --you guessed it-- Solaris machine. We check them out of source control and build them automagically, but as you can see from the noise below a book I just created from scratch on my Windows machine is not playing nice with FMbatch.

Drooping registered trademarks in cross references

2009-03-16 Thread Reid Gray
Hi Framers, I have a cross referenced heading. The heading includes a variable that includes a registered trademark. The problem is that the trademark in the crossreference droops after I perform a book update. I suspect Frame converts the character from subscript to normal after I update

Drooping registered trademarks in cross references

2009-03-10 Thread Reid Gray
Hi Framers, I have a cross referenced heading. The heading includes a variable that includes a registered trademark. The problem is that the trademark in the crossreference droops after I perform a book update. I suspect Frame converts the character from subscript to normal after I update