Hello all. At the company, we've recently had discussions on the future of printed manuals. Many software companies are moving towards CD-only packaging for many reasons. Today, if you buy the full professional version of Maple, you get all manuals printed. I just wanted to get a sense of your feelings on paper vs. electronic manuals. Thanks. T4.
Although, you may be referring to a PDF type manual, I'd like to say that really like the the ease of usage of the Maple online help, but something that I would REALLY like to see is a bookmarking system and/or maybe even the use of tabs as well so it has similar function to that of a book. For example, I often either fold the pages, or add sticky-tab page markers to books at places of interest, so the bookmark of an online book would be nice. Likewise, if I'm working on a particular problem, I'll often have various fingers marking various locations in the book manual at one time so I can easily flip between the pages of interest. Which would be similar to the use of software tabs.
Without at least this type of accessibility, I'd rather the manuals stay around.
I'll probably get banished for mentioning this, but what comes to my mind is the ability to add bookmarks within the MSDN Library that ships with something like Microsoft's Visual Studio 2005.
I'm rather new to Maple, so if these features already exist, please let me know how to access them.
p.s. Anyone know why, when I'm writing a message here, all the text within about the last 1/4 of this box is hidden by the frame on the right side that has things like "Announcements, Active Forum Topics, Recent comments, and Recent Files"?
Good ideas, It is hard work for keep manuals as printed, I think CD-only packaging like Maple is good for me too. it seem more cheaper and more easy-to-use.
I really like to have both. For quick reference, electronic is best - so much easier to search! For more careful reading, printed.
Use case 1: my screen is only so big, so when I do intense Maple stuff, I sometimes have several manuals open at critical pages on my desk, while I work on my computer. [Requires printed]
Use case 2: searching for a concept and its uses in Maple. Then full-text-search is the only way to go (otherwise the index to all the books would be 50 pages long!). [Requires searchable electronic version]
Use case 3: I am using a Maple command with a complicated calling sequence, and it is hard to get it right. I zip to a good example of use of that command, and then want to cut-and-paste that into my Maple session. [Requires version which allows cut-n-paste]
Note that Mathematica allows me to do all 3 of these very easily. Drawback: that doesn't help Maple users much!
Given the choice, I'd take just the hard copy. Admittedly, I don't use it much, but it is handy. Usually I'll read the entire set when it first arrives, then occasionally refer to a section of it for a task that is a bit too complicated to understand from reading help pages alone. Say, compiling an external program for use with Maple. While I've reviewed the electronic version (pdf), I've never actually used it. Is it really useful in the way you suggest, Jacques? I use the help database as you describe, but not the manuals. For electronic use I think they need to be improved---as a minimum the table of contents and index should be hyperlinked (actually, the ToC should have a browser window, so one doesn't have to ever go to the ToC). Pages should be rotated in the electronic version so that tables are readable. At least rotate them all the same way. In the Maple 11 Advanced Programming Guide, go to page 402 (in the pdf, 392 on the leaf). I can electronically rotate the page, but if I then go to the next page, with another table, it has to be rotated 180 degrees.
The pdf manuals are searchable, but not easy to use as a proper Maple resource, like the online help pages are. At least some of the material in the Advanced Programming Guide is also provided as source code in the Maple installation (although I have not checked that it is still there in 11, it used to be there); however that source code is not so easy to find. Unlike the Mathematica documentation, which is supports these diverse uses easily.
Perhaps this is just reiterating Jacques' point. For reference, online is probably best. However, a tutorial manual (like "First Leaves", or the Visual Basic introductory manual, to mention two very well written manuals) is to read to get an overview (or to read later as a reminder) and is much better as a hard copy. These also can retain their usefulness over several upgrades, whereas a reference work needs updating.
I would pass on distributing printed manuals with the product, even though I think the Maple introductory and programming guides are very nice. I ordered my original (black) version of the Maple V programming guide because I wanted a book, but now I have many copies of this book from different versions of Maple. They are almost all the same. I think you should distribute the current version of the manuals electronically with the product and sell printed copies inexpensively for people who want to have them.
I find it strains my eyes to read big chunks of an electronic manual or book. So, I am strongly in favour of printed manuals, but I like to have an electronic version for quick searches.
Roman has a point about (relatively) slow changes in programming guides, but if the guides could be produced in loose-leaf form, changes for updates would be short and relatively simple.
Generally, I prefer printed manuals. Recently, I bought a digital camera of Sony where the complete manual exists only on the CD. Shall I take a computer with me during vacation? As compensation a got abbreviated versions of the manual at six different languages.
For computer software, however, an online version of the manual is generally OK for me. Manuals of thousands of pages are rather unexpedient. Only for very difficult matters I prefer to print some pages, make notes on them, and throw them away again when the problem has been solved.
Comments
Printed manuals poll
Hello all. At the company, we've recently had discussions on the future of printed manuals. Many software companies are moving towards CD-only packaging for many reasons. Today, if you buy the full professional version of Maple, you get all manuals printed. I just wanted to get a sense of your feelings on paper vs. electronic manuals. Thanks. T4.
Although, you may be
Although, you may be referring to a PDF type manual, I'd like to say that really like the the ease of usage of the Maple online help, but something that I would REALLY like to see is a bookmarking system and/or maybe even the use of tabs as well so it has similar function to that of a book. For example, I often either fold the pages, or add sticky-tab page markers to books at places of interest, so the bookmark of an online book would be nice. Likewise, if I'm working on a particular problem, I'll often have various fingers marking various locations in the book manual at one time so I can easily flip between the pages of interest. Which would be similar to the use of software tabs.
Without at least this type of accessibility, I'd rather the manuals stay around.
I'll probably get banished for mentioning this, but what comes to my mind is the ability to add bookmarks within the MSDN Library that ships with something like Microsoft's Visual Studio 2005.
I'm rather new to Maple, so if these features already exist, please let me know how to access them.
p.s. Anyone know why, when I'm writing a message here, all the text within about the last 1/4 of this box is hidden by the frame on the right side that has things like "Announcements, Active Forum Topics, Recent comments, and Recent Files"?
Thanks,
Tim
Good ideas, It is hard work
Good ideas, It is hard work for keep manuals as printed, I think CD-only packaging like Maple is good for me too. it seem more cheaper and more easy-to-use.
----
software reviews
Both!
I really like to have both. For quick reference, electronic is best - so much easier to search! For more careful reading, printed.
Use case 1: my screen is only so big, so when I do intense Maple stuff, I sometimes have several manuals open at critical pages on my desk, while I work on my computer. [Requires printed]
Use case 2: searching for a concept and its uses in Maple. Then full-text-search is the only way to go (otherwise the index to all the books would be 50 pages long!). [Requires searchable electronic version]
Use case 3: I am using a Maple command with a complicated calling sequence, and it is hard to get it right. I zip to a good example of use of that command, and then want to cut-and-paste that into my Maple session. [Requires version which allows cut-n-paste]
Note that Mathematica allows me to do all 3 of these very easily. Drawback: that doesn't help Maple users much!
books
Given the choice, I'd take just the hard copy. Admittedly, I don't use it much, but it is handy. Usually I'll read the entire set when it first arrives, then occasionally refer to a section of it for a task that is a bit too complicated to understand from reading help pages alone. Say, compiling an external program for use with Maple. While I've reviewed the electronic version (pdf), I've never actually used it. Is it really useful in the way you suggest, Jacques? I use the help database as you describe, but not the manuals. For electronic use I think they need to be improved---as a minimum the table of contents and index should be hyperlinked (actually, the ToC should have a browser window, so one doesn't have to ever go to the ToC). Pages should be rotated in the electronic version so that tables are readable. At least rotate them all the same way. In the Maple 11 Advanced Programming Guide, go to page 402 (in the pdf, 392 on the leaf). I can electronically rotate the page, but if I then go to the next page, with another table, it has to be rotated 180 degrees.
Not very easily
The pdf manuals are searchable, but not easy to use as a proper Maple resource, like the online help pages are. At least some of the material in the Advanced Programming Guide is also provided as source code in the Maple installation (although I have not checked that it is still there in 11, it used to be there); however that source code is not so easy to find. Unlike the Mathematica documentation, which is supports these diverse uses easily.
depends
Perhaps this is just reiterating Jacques' point. For reference, online is probably best. However, a tutorial manual (like "First Leaves", or the Visual Basic introductory manual, to mention two very well written manuals) is to read to get an overview (or to read later as a reminder) and is much better as a hard copy. These also can retain their usefulness over several upgrades, whereas a reference work needs updating.
pass on printed manuals
I would pass on distributing printed manuals with the product, even though I think the Maple introductory and programming guides are very nice. I ordered my original (black) version of the Maple V programming guide because I wanted a book, but now I have many copies of this book from different versions of Maple. They are almost all the same. I think you should distribute the current version of the manuals electronically with the product and sell printed copies inexpensively for people who want to have them.
Eye strain
I find it strains my eyes to read big chunks of an electronic manual or book. So, I am strongly in favour of printed manuals, but I like to have an electronic version for quick searches.
Roman has a point about (relatively) slow changes in programming guides, but if the guides could be produced in loose-leaf form, changes for updates would be short and relatively simple.
J. Tarr
No voluminous printed manuals for computer software
Generally, I prefer printed manuals. Recently, I bought a digital camera of Sony where the complete manual exists only on the CD. Shall I take a computer with me during vacation? As compensation a got abbreviated versions of the manual at six different languages.
For computer software, however, an online version of the manual is generally OK for me. Manuals of thousands of pages are rather unexpedient. Only for very difficult matters I prefer to print some pages, make notes on them, and throw them away again when the problem has been solved.
If I were to need Maple
If I were to need Maple Professional, I would want printed manuals to help in training employees.