RE: What Program Do You Use for Software Documentation?

[quills -at- airmail -dot- net]

A multiple path transforming tool is any tool that will transform a 
file from one format to another, or several other formats. For 
example, from the binary format of a FrameMaker file to SGML or XML; 
or Flare taking a Word file and transforming it to HTML or XML.

And technical descriptions that confound the casual reader can be 
perfectly clear to anyone who shares your technical education and 
vocabulary. How you describe something to a software engineer who is 
involved in coding, isn't the way you would describe the same 
function to someone whose experience and knowledge is on the level of 
most consumer software users.

;)



At 4:30 PM -0700 10/22/08, Leonard C. Porrello wrote:
>Wow. Really? Are you serious? Have you actually ever used any of these
>tools? Perhaps you are working on your own private language?
>
>Of H&M, EC Software says, "Help & Manual 5 is a single-source help
>authoring and content management system for both single and multi-author
>editing."
>
>Of Flare, Madcap states, "Flare - The New Industry Benchmark in
>Multi-Channel, Single-Source Publishing."
>
>Among Adobe's list of "Top Features" for RoboHelp "Single sourcing" is
>listed sixth.
>
>Of Author-it, Author-it states, "Over 3500 clients in 50 countries are
>content in the knowledge that they have chosen the most reliable and
>proven system for authoring, content management, language translation
>management and single-source publishing to multiple outputs."
>
>Wikipedia (of all things) defines "single-sourcing" as follows: "Single
>source publishing, also known as single sourcing, allows the same
>content to be used in different documents or in various formats"
>(http://en.wikipedia.org/wiki/Single-sourcing)
>
>But perhaps you mean something different from the rest of the world when
>you say "single-sourcing".
>
>And what the heck is a "multiple plath transforming tool"? Did you mean
>multiple PATH transforming tool? If so, no worries about the typo. I
>often make them myself. But nevertheless, what the heck is a "multiple
>path transforming tool." Please, please tell me that you aren't writing
>for end users.
>
>Leonard
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing 
solution. Author in Doc-To-Help's XML-based editor,  Microsoft Word or 
HTML and publish to the Web, Help systems or printed manuals. 
http://www.doctohelp.com

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/ for more resources and info. 

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat