Archive for the ‘技术传播’ Category

技术文档工程师进行测试

2013年8月13日

作为技术文档工程师,你是否也兼职过测试的工作?

你是否对“让技术文档工程师进行测试比让测试人员使用正确的英语更容易”有同感?

呵呵,这当然只是一个玩笑,可是有时候可能还真是这样,特别是在非英语国家,因人而异吧。

回到上面第一个问题,我相信作为技术文档工程师,我们或多或少都做过一些测试工作。

...

技术写作工具和出版方式的在线调查

2013年8月7日

帮转一个关于技术写作工具和出版方式的在线调查。

调查8月31日截止,调查结果将于9月发布,欢迎积极参与。

...

Technical Writer 与开发测试的人员比例

2013年8月1日

Technical Writer (技术文档工程师)已经成为很多公司产品研发团队的组成部分之一。

那么,技术文档工程师与开发测试工程师的人员比例大概是怎么样的呢?是不是有一个比较合理的人员配比?

说实话,这很难有一个统一的答案。由于行业、产品和项目的不同,对技术文档工程师数量的要求可能也会各有不同。

下面给出的人员比例,主要是根据与前辈和同行的交流以及自己的个人经验总结出来的,比较主观,而且主要针对软件行业。

...

什么是 Structured Authoring 和 XML?

2013年6月8日

上一篇文章谈到了 Structured Authoring,什么是 Structured Authoring?

这里推荐 Sarah O'Keefe 写的一篇 Whitepaper,写得很详细。除了 Structured Authoring,这篇 Whitepaper 还对 XML 进行了介绍。

...

Structured Authoring 适合 Web 吗?

2013年6月7日

Structured Authoring,几乎所有业内人士在介绍技术写作趋势的时候,都会提到“她”。

Dita and the Web

她,真的有那么好吗?

上个月Tom Johnson发表了一篇名为"Is Structured Authoring (like DITA) a Good Fit for Publishing on a Website?"的博文,Tom 列出了Structured Authoring对于Web的各种不适应。这篇文章引发了美国技术写作圈子的热烈争论,不少业内人士都进行了回复,表达自己的观点。其中Sarah O'Keefe还在自己博客中剑拔弩张,针锋相对,对Tom的观点逐一进行反驳。

...

读者就是上帝!还是老奶奶?

2013年6月6日

今天偶然又看到了以前曾经看过的一个段子,那时候还没有自己的博客,所以现在就记录一下吧。

这个段子是这样的:

我们年轻人都知道Facebook,可是如果有一天,一个老奶奶问你什么是Facebook的时候,你会给出怎样的解释呢?她会明白吗?

...

术语管理在技术文档写作中的重要性

2013年6月1日

今天看了Content Rules上的一篇whitepaper,标题是"Shepherding Your Content for Operational Efficiency"。这篇文章详细阐述了术语管理(Terminology Management)对于提高文档写作效率和提高内容效用的重要性,并给出了应该如何进行术语管理的建议。

Graphic - Shepherding Your Content for Operational Efficiency

的确,从我个人的经验来看,许多公司在文档写作中对于术语或者说是用词用语的管理,真的就像文中所说一样,通过Word或者Excel来维护一个词汇列表,又或者是把它加入到公司所谓的style guide中并加上使用说明。

问题出现了,大家真的会经常查看这样术语列表吗?

...

eBook是如何创建出来的?

2013年5月3日

随着移动手持设备(主要是手机和各种pad)的不断进步和普及,电子书(eBook)也越来越被人们广泛使用。一本制作精良、互动性上佳的电子书能够带来良好的用户体验,从而促进内容的传播。

那么一本eBook是如何制作出来的呢?Aptara公司通过下面的一张图片向我们简单介绍了eBook的制作过程。不知道国内是不是也有这样专注于数字出版和移动设备内容的公司呢?个人认为,这对technical writer来说也是一个值得关注的领域和发展方向,毕竟电子阅读和移动阅读也是大势所趋。也许以后我们输出的文档将不只是直白的pdf,还会包括互动性更强的eBook了。

create an ebook introduction

...

英文技术写作笔试

2013年4月9日

笔试基本上已经成为很多公司招聘技术文档工程师过程中的一个必不可少的步骤了,特别是在招聘母语不是英语的英文技术文档工程师的时候。通过笔试能够大致了解应试者的英文基本功,技术文档写作水平,分析能力,是否足够细心等等。

因此,笔试的结果也将很大程度上影响应试者最终能否应聘成功。个人认为,笔试的结果对于衡量一个技术文档工程师的比重可能占到50%甚至还要更多。在我面试过的候选人中,其实就有不少面试感觉很不错,可是最后因为笔试成绩不理想而没被录用的,我觉得挺可惜的。

好了,其实今天写到这个话题是因为看到了一个Tech Writer 在线测试的网站,还挺有趣的,所以在博客里给想成为英文技术文档工程师的同学们推荐一下。之所以推荐是因为这个测试简单明了,而且不需要花很长的时间,就可以对自己的不足之处有一个了解。据说还真有公司用这个测试来进行笔试的。需要说明的是,题目还是比较简单和基础的,适用于比较初级Technical Writer的测试(暗自庆幸自己基本上全都做对了,呵呵)。

下面是这个网站的地址,有兴趣可以去试一下:

...

(中国)技术文档工程师的工资待遇

2013年4月8日

在STC intercom 2013年1月的一篇名为"Technical Communication in China: A World to Be Won"的文章中给出了对中国技术文档工程师的工资调查结果,平均工资大约是5500元人民币。个人觉得如果是在一线城市,这个技术文档工程师的平均工资偏低了。当然,文章也说明了这只是一个基于Fenzhi.com上数据的调查结果,样本为102个,并没有对地域和文档工程师的经验等因素进行区分,大家参考一下吧。

以下内容引用自该文章:

...