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.
RE: The State of DITA; was, I'm now blogging about Agile & TW
Subject:RE: The State of DITA; was, I'm now blogging about Agile & TW From:"Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com> To:"Kevin McGowan" <thatguy_80 -at- hotmail -dot- com>, <hamonwry12 -at- hotmail -dot- com>, <jposada99 -at- gmail -dot- com> Date:Thu, 3 Dec 2009 11:14:30 -0800
Many thanks to Kevin and everyone else who has responded or may yet
respond.
Leonard
________________________________
From: Kevin McGowan [mailto:thatguy_80 -at- hotmail -dot- com]
Sent: Thursday, December 03, 2009 7:07 AM
To: Leonard C. Porrello; hamonwry12 -at- hotmail -dot- com; jposada99 -at- gmail -dot- com
Cc: TECHWR-L
Subject: RE: The State of DITA; was, I'm now blogging about Agile & TW
Hi Leonard and everyone...
I've been using DITA exclusively at my last two jobs. I found that its
success was pretty much dependent on me (and my immediate manager). Case
in point, at my previous job, my then-manager and I brainstormed and
decided DITA was THE way to go. I converted a thousand pages of goop
into pretty little topics, and we moved forward with great plans of
using those raw XML files as the online help system in our web-based
product. Things looked really good.
Then, my manager left. Then, I left. I did a little consulting work with
that team after my departure to help them navigate through DITA, but the
remaining folks found it too confusing (none of those remaining were
documentation people, btw). As far as I know, they outputted all my old
DITAMAP files into Word documents, and are back in the world of Word
making all the same mistakes that I corrected when I converted it to
DITA.
In my current position, I was hired because my manager liked the DITA
concept when we talked about it in my interview. We create training
materials here (we train federally appointed judges in Canada on
relatively basic computer skills etc). My trainers absolutely LOVE the
fact that they can be prepping a course for some judges, give me a list
of topics they want to focus on, and I can whip up a DITAMAP, FrameMaker
book...and then a PDF in about an hour.
To summarize, I think DITA adoption is on the rise, but without a true
champion for it in your organization, you won't get very far.
Non-writers find authoring in XML to be a pain in the neck...
That's my $0.02.
Cheers,
Kevin
> Subject: The State of DITA; was, I'm now blogging about Agile & TW
> Date: Wed, 2 Dec 2009 12:50:24 -0800
> From: Leonard -dot- Porrello -at- SoleraTec -dot- com
> To: hamonwry12 -at- hotmail -dot- com; jposada99 -at- gmail -dot- com
> CC: techwr-l -at- lists -dot- techwr-l -dot- com
>
> Ed's post makes me wonder; how is DITA doing in the real world? Is
> adoption increasing, leveling off, or declining? What's the rate of
DITA
> adoption failure? Are TW teams that successfully adopted DITA finding
it
> worth while and sticking with it?
>
> Leonard
>
> -----Original Message-----
> From:
techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- com
>
[mailto:techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- c
> om] On Behalf Of Ed
> Sent: Wednesday, December 02, 2009 12:39 PM
> To: 'John Posada'
> Cc: 'TECHWR-L Writing'
> Subject: RE: I'm now blogging about Agile & TW
>
> I was heavily involved in an DITA implementation for a department of
40
> here
> in NYC. It was a fight the entire way, and I'm not even sure the
> company's
> using DITA anymore.
> -=Ed.
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Are you looking for one documentation tool that does it all? Author,
> build, test, and publish your Help files with just one easy-to-use
tool.
> Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
>http://www.doctohelp.com/
>
> Help & Manual 5: The all-in-one help authoring tool. True single-
sourcing --
> generate 8 different formats and as many different versions as you
need
> from just one project. Fast and intuitive. http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as thatguy_80 -at- hotmail -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/thatguy_80%40hotmail.
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
>
Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at: http://www.doctohelp.com/
Help & Manual 5: The all-in-one help authoring tool. True single- sourcing --
generate 8 different formats and as many different versions as you need
from just one project. Fast and intuitive. http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-