TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
>--- Peg Bogema <peg -at- stout1 -dot- com> wrote:
>> (1) Do you know what a MAN PAGE is?
My first technical communications project was developing newbie helps
screens for a UN*X-based system.
Manpages are not help-as-we-know-it.
Every command/program/whatever in UN*X has a manpage, which will tell you
everything there is to know about how the command /program/whatever works
(but not why or how).
Unlike task-based Help for GUI applications, man pages tend to be purely
reference material in style and structure: they are rather structured, and
style is important... I had the hardest time figuring them out at first,
but the "Coffee man page" helped me understand both how they work and what
they're about.
Sorry to say my old bookmarks for *ALL* official manpages don't work
anymore-- they've moved.
>> (2) Will Acrobat Reader work on UNIX?
>>
Yep, depending on the flavor of UNIX you're using, there is probably a
Reader already setup for it: you can always build your own distribution for
any flavor of UNIX or Linux (I didn't say it would be easy ;-)
There's also xPDF and PDF-blit, which are useful independently developed apps.
>> (3) Can one create straight HTML for a UNIX browser?
Sure... If you know basic HTML, or can use WebWorks, etc... There are more
browsers available for UNIX than any other platform: Netscape, Opera, and
OmniWeb are some GUI browsers that spring to mind; the basic text-only web
browser for UNIX is called Lynx.
Remember that the web and HTML were invented on UN*X (NeXT machines,
actually)...