Article View: adobe.framemaker
Article #25669Re: Will the FM user go the way of the dodo?
From: Scott Meltzer
Date: Fri, 28 Jun 2002 14:21
Date: Fri, 28 Jun 2002 14:21
15 lines
2933 bytes
2933 bytes
The answer to your question is directly related to the mindset of corporate America. As the importance of usable documentation wanes, so will the need for an experienced FM user. I have been a technical writer for more than 10 years doing projects for high-tech companies and I have yet to meet a subject-matter-expert capable of or interested in creating completely usable text, much less a well-published document. (When I was at Philips Semiconductors, they developed a Framemaker SGML application solely for the purpose of having IC designers produce their own datasheets. The fact that Philips created an excellent template didn�t keep the project from failing. The problem was twofold: they didn�t create any user documentation for the SGML application and the engineers really weren�t serious about doing desktop publishing.) Out of 20 projects that I have been involved with, more than half of them have required me to create text from scratch. Sometimes I only supplement source matter and sometimes the content of the document I create is written entirely by me. As for the projects where I merely "published" content from SMEs, I have had to heavily edit the source material for grammar, punctuation, spelling, etc.. And then there is the time spent on content organization. In addition, I normally have to fiddle with the template being used. This all adds up to a good bit of work. I have found that a lot of companies don't know what they want re: documentation and do not believe in the importance of sound documentation. l believe that sloppy documentation in any form is not an issue for most of the companies that produce it. On this exact point, has anyone besides me noticed the terrible writing in documents in the "OnlineManual" folder of Framemaker 7? I realize that there are quite a few mistakes in those documents due to bugs in the PDF process, but some of the grammar mistakes are unbelievable. Or how about the hard-copy users manual for FM 7. I don't understand how extra pages were included, especially since the extra pages were spread across two chapters! If these types of mistakes are acceptable, then I agree with your initial assertion.
Technical Details
Message-ID:
<ef8c48f.34@WebX.aaQKaf7vad4>Path:
arc1-ca.pugleaf.net!archiver1.google.com!news1.google.com!sn-xit-02!sn-xit-05!sn-xit-06!supernews.com!news.maxwell.syr.edu!news.stealth.net!news.stealth.net!gatel-ffm!newsfeed01.sul.t-online.de!t-online.de!WebXReferences:
<ef8c48f.-1@WebX.aaQKaf7vad4>Show Full Headers
Complete Article Headers
X-Google-Language: ENGLISH,ASCII X-Google-Thread: fd315,fdd01679cec59e00 X-Google-Attributes: gidfd315,public X-Google-ArrivalTime: 2002-06-28 07:38:28 PST From: "Scott Meltzer" <sam@webcom.com> Path: arc1-ca.pugleaf.net!archiver1.google.com!news1.google.com!sn-xit-02!sn-xit-05!sn-xit-06!supernews.com!news.maxwell.syr.edu!news.stealth.net!news.stealth.net!gatel-ffm!newsfeed01.sul.t-online.de!t-online.de!WebX Newsgroups: adobe.framemaker Subject: Re: Will the FM user go the way of the dodo? Message-ID: <ef8c48f.34@WebX.aaQKaf7vad4> Date: Fri, 28 Jun 2002 07:21:22 -0700 References: <ef8c48f.-1@WebX.aaQKaf7vad4> Lines: 42 MIME-Version: 1.0 Content-Type: text/plain; charset="ISO-8859-1" Content-Transfer-Encoding: 8bit