Best software for making manuals

GEC: Discuss gaming, computers and electronics and venture into the bizarre world of STGODs.

Moderator: Thanas

Post Reply
User avatar
SCRawl
Has a bad feeling about this.
Posts: 4191
Joined: 2002-12-24 03:11pm
Location: Burlington, Canada

Best software for making manuals

Post by SCRawl »

Just what the topic says. We're going to have to start making technical/instruction manuals for products we're developing at work, and I'd like to know what software comes recommended by the big giant heads here for this purpose. Cost isn't a strong issue (i.e. I'm not looking for freeware), but user-friendliness and functionality are. The manuals will be primarily text with graphics, and the graphics will be primarily from sources like Autodesk Inventor or photographs.

I stand ready to bask in your collective wisdom.
73% of all statistics are made up, including this one.

I'm waiting as fast as I can.
User avatar
phongn
Rebel Leader
Posts: 18487
Joined: 2002-07-03 11:11pm

Post by phongn »

Framemaker is the king of structured document creation but is also very expensive. You could also use LaTeX (free) but that has a steeper learning curve.
User avatar
sketerpot
Jedi Council Member
Posts: 1723
Joined: 2004-03-06 12:40pm
Location: San Francisco

Post by sketerpot »

phongn wrote:Framemaker is the king of structured document creation but is also very expensive. You could also use LaTeX (free) but that has a steeper learning curve.
If you decide to go with LaTeX, you can make it easier on yourself by using LyX. It runs on Linux and Mac OS X well, and on Windows usably. It's very nice, and well documented so you can get started quickly with it.
User avatar
phongn
Rebel Leader
Posts: 18487
Joined: 2002-07-03 11:11pm

Post by phongn »

Meh, I wasn't too impressed with LyX. Also, font-handling is something of a nightmare in LaTeX. You can do it but it takes a non-trivial amount of work.
General Brock
Jedi Council Member
Posts: 1739
Joined: 2005-03-16 03:52pm
Location: Land of Resting Gophers, Canada

Post by General Brock »

If this is just for in-house use, you might consider an older version of Adobe Pagemaker. There may be trouble with exotic fonts in versions 5.0 and up, because of a lawsuit brought by font manufacturers, but 4.0 is used by a print shop I go to. If you can already make PDFs, this might be an option. Pagemaker 6.52 includes the PDF Distiller.
User avatar
SCRawl
Has a bad feeling about this.
Posts: 4191
Joined: 2002-12-24 03:11pm
Location: Burlington, Canada

Post by SCRawl »

General Brock wrote:If this is just for in-house use, you might consider an older version of Adobe Pagemaker. There may be trouble with exotic fonts in versions 5.0 and up, because of a lawsuit brought by font manufacturers, but 4.0 is used by a print shop I go to. If you can already make PDFs, this might be an option. Pagemaker 6.52 includes the PDF Distiller.
This is actually for business use, and not by me. The company I work for (we make elevators) also employs someone who is a giant in this field (and has been for decades), and he'll be the one using the software. He is only a fair-to-middling computer user, though, hence the requirement for user friendliness.

Still, Pagemaker sounds like an idea. My personal preference is to let a professional do the layout once he's got the text, but since that costs money, I might get the thumbs down.
73% of all statistics are made up, including this one.

I'm waiting as fast as I can.
Post Reply