Archive for the ‘TC沪联’ Category

Affective Writing (Emotional Elements) for Technical Documentation

2012年11月15日

今天抽空听了 Ellis Pratt 为 Madcap 做的一个 Webinar,主题是"Affective Writing: Turning Technical Documentation into an Emotional Experience for the User"。我们知道,目前主流的 Technical Documentation 的 Writing Style 是要避免太口语化,富有情感,或带有宣传色彩的表达。一方面的原因是这样的风格让技术文档显得不太专业,另一方面是如果涉及到文档的本地化,这样的语言不好翻译。

...

Technical Writer Community in China

2012年11月12日

上个周末一个同行打来电话,说12月份可能会在上海筹划一个 technical communication 的沙龙。联想到最近在一些同行的博客以及 Linkedin 上面看到上个月在北京大学也举办了类似的活动,据说参加人数远超预期,达到了120人,而且气氛很好,大家都很积极。不禁要感叹一下,techinical communication在中国从几年前的萌芽发展到现在,已经有越来越多的人从事这项工作,因此自然也就有了需要一个(或多个)组织来促进大家的沟通交流,推动行业发展的需求。很高兴看到自己从事的行当有了发展和进步,希望上海的活动也能举办成功。自己有时间也会去参加,向同行学习。

另外,顺便提一下,由于自己也在开始做关于 technical writer 的 blog 及网站,所以时不时也会关注一下同行是否也有在写相关博客。我发现从这一两年开始,一些中国同行也开始在记录他们的工作经验和体会,虽然数量还十分有限,但比起几年前的已经多了不少(以前基本上只能看到 native speaker 的记录)。哈哈,这么说来,自己是不是也在为这个 community 在中国的发展在做一些贡献呢,至少以后想入行的同学们如果搜索到我的网站或 Blog 的话,可以或多或少的了解一些相关的信息吧。

下面是我看到的其中一个中国 writer 的博客,内容也还不算多(但是比我的还是要多不少,哈哈,我太懒了。。。。),大家可以时不时关注一下:

...

"The xxx parameter" vs. "The parameter xxx"

2012年11月2日

前段时间一个 native speaker 和我们讨论下面两个说法应该是用哪个,parameter 的名字应该是放在前面还是后面的问题。

1. The xxx paramenter has been introduced in this release.

2. The parameter xxx has been introduced in this release.

...

Word 转 PDF 目录(TOC)链接无效

2012年10月23日

有时候用 Adobe 的插件将 word 文档转成 PDF 的时候会发现转出来的 PDF 的目录不能像原来的 word 文档一样通过点击鼠标进入相应的章节。这是因为在 word 里生成生成目录的时候是用的 page number 而不是 hyperlink。要解决这个问题很简单,只要在生成目录的 Table of Content 菜单中将 Use hyperlinks instead of page numbers 的 checkbox 选中,然后再输出 PDF 即可。

...

[Podcast] Technical Writer Career

2012年10月22日

Tom 在 College Funding Resources 组织的 Career 100 中介绍 Technical Writer 以及他个人的经验和建议。Technical Writer 确实不只是 Writer,工作也不仅仅是写文档,所以很多的技术文档工程师更喜欢 Technical Communicator 这个名称吧。不过能像 Tom 的那样只有 20% 的工作时间是在 Writing,估计很多国内的公司都做不到,呵呵。

想要了解 Technical Writer 这个职业的同学可以去听一听:

...

RTFM

2012年9月19日

上周五老板给我们发了一篇关于 RTFM 的文章 The Blame Game of RTFM,写得挺有意思的,writer 和 user 都要共同努力才能减少 RTFM。这个idratherbewriting博客很早就知道了,博主 Tom 对 technical writing 充满热情也很有见解。我要多多向前辈学习,希望以后也能写出很多有见解的文章。哈哈~

普及一下,RTFM 是 Read The F**king Manual 的意思,其实自己也是最近才知道。自己也顺便多了解了一下关于 RTFM 的解释,没想到 iOS 自带的词典也有解释:read the f**king manual (used esp. in e-mail in reply to a question whose answer is obvious)。因为其中的 Fxxking 不太和谐,很多人也把 F 替代成 Friendly, Fine, Fantastic, Foolish 等等。与 RTFM 类似 ,STFW (Search The F**king Web) 和 UTFG (Use the F**king Google) 也都是用来表达明明可以自己查找到答案,却要将这些问题拿出来提问,让回答者感觉浪费了自己的时间。

First blog

2012年8月26日

First blog on www.technicalwriter.cn/blog.

Hello, world!