Slashdot Mirror


Are Printed Manuals Dead?

Bantik asks: "I work for a software publisher, and there's a raging debate going on upstairs about whether or not we should continue providing printed manuals. I think that between a program's Help menu, documentation in PDF form on the program CD, and the online documentation on our Web site (HTML and PDF), we're fine. What do /.'ers think? Are printed manuals a thing of the past? And what major software vendors are going down the Paperless Path?" While some of my peers would just love to declare paper dead and a thing of the past, I feel that physical manuals are still very necessary. There's nothing like having a reference you can flip to and computers aren't common enough that there's one at every place you might find the time (or desire) to read. Thoughts?

2 of 376 comments (clear)

  1. Re:Paperless is the way to go. by dbarclay10 · · Score: 5

    1) Microsoft, after supplying only the BARE minimals worth of documentation, sold the "Resource Kit"(which was really a good manual) for $60+.

    2) You much has a really nice novel, and a really nice seat. When I've got to learn a programming language from on-line/on-screen docs, it takes me about three times as long as if I had a printed book. Mostly because it's harder on the eyes, I can't bring it with me when I go to pick somebody up at the airport(that's a good 2 hours of wasted time), etc., etc..

    Printed manuals and books, I feel, will become a precious commodity. I have no problem with that - so long as I can get them. :)

    Dave

    --

    Barclay family motto:
    Aut agere aut mori.
    (Either action or death.)
  2. Some manuals must be on paper by LordNimon · · Score: 5
    The following documentation must be provided on paper:
    • Installation Guide - until the software is installed, online docs don't work. And no, HTML or PDF documentaion is not enough - it requires the user to have other software installed. Besides, most installation programs can't share the screen with other windows, so the user won't be able to see the online docs anyway.
    • Troubleshooting - if something is wrong with the software or computer, online docs will again not work.
    • Getting Started and Tutorials - people who read these documents, by definition, need some hand-holding, so they need to be able to read the documentation and run the software at the same time, and it's usually difficult to fit both on the screen at the same time.

    Basically, there are three advantages for paper documentation:

    • Ability to read the documentation when you're not at the computer. However, I'm not sure if this has any real value, since I personally have had little success in understanding the documentation without the software right there to show me what's going on.
    • Ability to read the documentation when administering software remotely. Unless your documentation is available in cross-platform text, PDF, or HTML format, it's usually impossible to read it online from a different computer. Imagine setting up a Samba server remotely? If the docs weren't in text format, most people wouldn't be able to read them!
    • When you need to read the docs and use the software at the same time. Unless the user is running at 1600x1200, the screen is usually too small to display the application and the online documentation at the same time.

    Advantages of online documentation include:

    • Frequent updates. Online documentation is typically more correct than printed documentation. If you discover an error in the documentation, you can simply provide a new PDF (or whatever) for download.
    • Total electronic delivery. A user can purchase and download the entire application in one shot. If the documentation were available only on paper, you couldn't download it.
    • Cost reduction.
    • Environmental savings.

    Giant reference manuals, which are seldomly used, are a good example of documentation that can be placed online only.

    One thing you should always do is provide all of your documentation electronically. A user should be able to view all the documentation online if he chooses. Never provide any documentation in paper format only. You may also want to sell two versions of the application: one with and the other without paper manuals. The version without paper manuals should be cheaper.

    --
    And the men who hold high places must be the ones who start
    To mold a new reality... closer to the heart