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.
Subject:TECHWR-L Premium Jobs, Events, and Announcements From:TECHWR-L Listowner <admin -at- techwr-l -dot- com> To:archive -at- web -dot- techwr-l -dot- com Date:Thu, 1 Jul 2010 01:05:08 -0600 (MDT)
Posted on
Thursday, July 01, 2010
________________________________________________________
TECHWR-L Premium Ads
You received this message because you're a subscriber to TECHWR-L.
This ad posting is sent daily directly to all list members to help
underwrite the costs of the list (just as ads in a newspaper,
magazine, or journal underwrite the costs of those publications).
In this posting, look for the following ...
ANN: MadNewz, a Community-Written MadCap Newsletter Launches
ANN: Help & Manual offers Source Code Docs for Visual Studio
and at the end you'll find the concluding administrivia with
information about these ads and how to place your own.
ANN: MadNewz, a Community-Written MadCap Newsletter Launches
MadCap Software has launched a new community-written newsletter,
MadNewz, aimed to give users another channel to share ideas and
information with their peers. The first MadNewz post, written by Chris
Sullivan, Director of Technical Communication and Social Media at
AVST, covers best practices for Flare single-sourcing and includes a
cost-calculator sheet available to download. Find the article at: http://www.madcapsoftware.com/madnewz/june2010.aspx
MadCap also plans to host a free live webinar presentation for each
article a few weeks after the article post date. Chris Sullivans
webinar will take place July 1, 2010 at 10am PST. You can sign up at: https://www1.gotomeeting.com/register/511929529.
For those of you interested in submitting article ideas, you can
contact MadCap Software at:
madnewz -at- madcapsoftware -dot- com -dot-
##################################################################
ANN: Help & Manual delivers Source Documentation for Visual Studio
Help & Manual from EC Software has always been the best tool for
writing online help for software applications. With its power and ease
of use, Help & Manual is firmly established as the favorite help
authoring tool for software developers across all languages. Its the
perfect solution for creating and updating application help and
documentation in multiple formats.
Source code documentation is a slightly different story, however. All
serious programmers know their source code needs to be documented. The
question is how, in how much detail and in which format. Source code
documentation belongs in the source code, you will say. And youre
absolutely right!
For Microsoft Visual Studio programmers, there is already a de facto
standard for source code documentation: Microsoft Sandcastle, a
command line tool that extracts source code comments and outputs HTML
or compiled HTML Help, ready to deploy. But Sandcastle does not have a
text editor, and Help & Manual now fills this gap in a stunning
manner.
Help & Manual now runs Microsoft Sandcastle to read your Visual Studio
source code and comments, builds the documentation structure for your
functions and classes, integrating the comments found in the source.
Then, instead of compiling the finished CHM or HTML files, it
transforms the Sandcastle XML data into a Help & Manual XML project,
which you can then edit in Help & Manual, alone or in a team, and
publish in any of the many supported output formats.
That gives you two documentation tools in one! Help & Manual is an
integrated XML-based help authoring suite for developing interactive
help in HTML-based formats and print-style documentation as PDF files.
It radically simplifies and accelerates the documentation process with
an intuitive user interface that is very similar to the modern word
processors that all computer users are already familiar with. Authors
can focus on writing and editing their content rather than struggling
with the details and quirks of multiple output formats all that is
handled by the program.
Help & Manual 5.4 is available from $349 per single user license
(Standard) to $499 (Professional Edition).
You can download a free trial of Help & Manual from the link below.
Note that for source code documentation, Microsoft Sandcastle needs to
be installed separately!
About posting ads:
Announcements on the TECHWR-L Premium Announcement posting
cost $50 to contact over 5000 TECHWR-L subscribers
directly each day for a week.
In an effort to provide a free service that allows you to post
announcements, jobs, and events, however, we have established other
services:
The TECHWR-L Calendar provides a free resource for you
to post announcements, activities, and events: http://www.techwr-l.com/event
These resources are available at no cost to anyone, posters
or seekers, TECHWR-L subscribers or not. We encourage you to
regularly use these free services.
For jobs, announcements, and events that you specifically
want to be mailed directly to all 5100+ TECHWR-L subscribers
in the TECHWR-L Premium Daily Announcement, please contact us
(admin -at- techwr-l -dot- com) or submit your paid ad at http://www.techwr-l.com/about/advertising
