🚀 go-pugleaf

RetroBBS NetNews Server

Inspired by RockSolid Light RIP Retro Guy

Article View: adobe.framemaker
Article #25321

FM clean up... HELP!

#25321
From: John Sylte
Date: Tue, 16 Jul 2002 22:06
21 lines
2608 bytes
Hello fellow Frame users, 

I began working with my company as their tech writer last year, volunteering to update our 900 page user's manual after the previous tech writer hit the road. To say that he held FrameMaker in contempt would be an understatement. I inherited a book that was plagued with just about every imaginable FM problem. Since I had too little time to prepare for and finish the task the right way, I took the crash course in FM and basically fixed what I could see when I saw it, but otherwise mimicked the status quo. I am now undertaking the task of cleaning up the whole document before beginning the next update. I have a huge list of clean up issues, most of which I am prepared to deal with, but I am wondering if anyone can tell me if there is a specific order or process I should follow, as everything is related to everything else. I feel a little paralyzed by which step to take first. I have these issues on my plate: 

1)My book is riddled with redundant paragraph/character formats and overrides on nearly every page. 

2)My book has inconsistent file, directory, and graphic naming conventions. 

3)Many graphics are of different filetypes (wmf, jpg, tif), and a large minority of them are embedded, not referenced. 

There are other issues, but they are not so tangled with all of this. I have a couple questions... 

Q: Regarding cleanup, should I finalize my content issues first (standardizing formatting and graphics) and then establish solid file/directory/graphic structure and naming conventions second, or is the other way around a better way to go? 

Q:Can any of you recommend file/directory/graphic structure and naming conventions that have been proven successful? We update our manual annually, and it is the foundation for our context sensitive help which covers nearly a thousand help IDs'. 

Any help would be GREATLY appreciated. 

Thanks! 

John Sylte
Technical Details
Message-ID: <ef9b029.-1@WebX.aaQKaf7vad4>
Path: arc1-ca.pugleaf.net!archiver1.google.com!news1.google.com!sn-xit-02!sn-xit-06!sn-xit-08!supernews.com!newsfeed.news2me.com!opentransit.net!fr.clara.net!heighliner.fr.clara.net!newsfeed01.sul.t-online.de!t-online.de!WebX

Show Full Headers
Complete Article Headers
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: fd315,21df7269103e818f,start
X-Google-Attributes: gidfd315,public
X-Google-ArrivalTime: 2002-07-16 15:11:56 PST
From: "John Sylte" <jsylte@chiefarchitect.com>
Path: arc1-ca.pugleaf.net!archiver1.google.com!news1.google.com!sn-xit-02!sn-xit-06!sn-xit-08!supernews.com!newsfeed.news2me.com!opentransit.net!fr.clara.net!heighliner.fr.clara.net!newsfeed01.sul.t-online.de!t-online.de!WebX
Newsgroups: adobe.framemaker
Subject: FM clean up... HELP!
Message-ID: <ef9b029.-1@WebX.aaQKaf7vad4>
Date: Tue, 16 Jul 2002 15:06:39 -0700
Lines: 43
MIME-Version: 1.0
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: 8bit