他们做过以后都说DITA没价值,为什么?

DITA是成功的吗?

每个公司的DITA实施都成功了吗?答案显然是否定的。三年前的DITA Europe大会上,几个演讲都对DITA持怀疑的态度,认为他们的项目未能获得价值。

DITA在欧洲水土不服了吗?

作为一枚DITA资深粉,我向DITA技术委员会的总编辑JoAnn博士提出了我的疑问。

JoAnn博士很淡定的说,质疑何时停止过呢?只不过是不同的DITA之路罢了。

与JoAnn博士在DITA Europe会议现场开心合影

JoAnn博士推荐的DITA实施路径 

立一个业务项目,而不是IT项目。

首先用最小化方法(Minimalism)进行内容分析,不要把冗余的内容带入试点项目。建立一支信息架构团队,开发企业级的信息模型。

评估历史数据,决策哪些内容必须迁入DITA。现有内容不经过重新架构,直接进入结构化写作的环境,是没多大价值的。

下一步就是识别发布需求,针对PDF、HTML等输出要求开发样式表。

接下来启动一个小而美的试点项目。通过试点,优化信息模型,开发DITA的写作指南,把结构化写作的精髓落实到位,把基于DITA的工作流建立起来。

识别内容管理系统CCMS的需求。项目启动时不一定有内容管理系统的要求,但考虑到后续Topic数量级,系统非常关键。

对试点项目进行总结,对比立项时的收益预期,向各级组织汇报,并提出下一步的推广计划。

DITA路上的那些坑 

乍一看,JoAnn博士提出的方法论,与任何一个IT系统上线都差不多——我也是这么做的啊!

项目经理表示不服。

你这么做了却没成功,可能是以下这些坑:

1. 这是一个业务项目,不是IT项目,做DITA的目的不是为了用新的工具编写原来的手册。

2. 核心在于最小化。DITA产生之前,最小化已经是IBM的信息开发基础,每个新Writer的必修课。IBM写作宝典中,核心思想就是面向任务的写作。大家以为IBM开发DITA标准是为了同源和Reuse,但别忘了,DITA的基因是最小化和任务导向。

3. 建立一支企业级的信息架构团队。JoAnn没有说要什么样的素质模型。参照IBM的分级,你得有战略级和战术级架构师,其中战略级是要求非常高的,负责进行企业级信息架构的设计;战术级要懂任务导向、XML,理解DITA数据的逻辑关系。

4. 试点项目逃避业务规则建立。DITA项目在于新写作方法论的落地。因此在试点项目中,必须输出写作指南,而不只是标记对使用规范。你的内容怎么写,是由你的受众需求决定的,DITA提供了直接面向用户任务写作的机制,如何用好这个机制才是关键。

5. 浪费大量时间和人力去转历史数据。Junk in, junk out。

怎么做才能避免掉坑  

正确的方法论 + 能打硬仗的信息架构师团队,是DITA实施成功的保障。过去十几年我经手的DITA实施项目有得有失,下次我会跟大家讨论方法论。从DITA到企业级信息架构设计,还有很长一段距离要跨越。

信息架构师的岗位定义和素质模型,可参考《技术传播入门手册》3.1节中的信息架构师分级模型。

在你做过的DITA实施项目里,对哪个难点最有体会呢?欢迎共同探讨。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,657评论 6 505
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,889评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,057评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,509评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,562评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,443评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,251评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,129评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,561评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,779评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,902评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,621评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,220评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,838评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,971评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,025评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,843评论 2 354

推荐阅读更多精彩内容