【实践分享】那些年我们弄丢的文采

文章讲述了在文档开发中遇到的沟通难题,强调了理科生和技术背景人员在写作时可能忽视语言的流畅性和美感,导致文档可读性降低。通过对比理科生与文科生的表达方式,指出提升技术文档可读性的重要性,并提倡跨领域的学习和理解。
摘要由CSDN通过智能技术生成

 

余光中先生在他的著作《翻译乃大道》中说:“措词简洁、句式灵活、声调铿锵,这些都是中文生命的常态。能顺着这样的生态,就能长保中文的健康。要是处处违拗这样的生态,久而久之,中文就会污染而淤塞,危机日渐迫近。”

然而在现实生活中,做到措辞简洁,语言通顺却很难。众所周知,文档开发工作中最容易的部分,无非是现有项目的维护,文档工程师会参考已有的文档,适度优化化和更新,经简单评审后,便可重新发布。

 

Part 1 项目故事

 

最近收到一文档需求,开发优化了原有的产品功能,需要修改相关功能官网图文界面描述,简短沟通后,开发同学的分工是:修改原有官网文章描述过期的地方,发送初稿给我优化更新。然而,这成了麻烦的开端,一天后,我拿到的初稿表达晦涩,漏洞百出,仍然需要开发同学继续解释,一来二去两个回合,这些都是开发流程中日常的工作。

 

有趣的部分是,一开始我以为是开发同学没有按照官网的原文修改,后来发现不是。问题出在,以前官网的文档是理科生写的(在我看来表达含混,满屏术语的文档都是理科生的作品),左边是官网的原文,右边是优化后的输出。

 

官网原文

优化后

根据筛选条件,呈现按小时-天等维度展示的不同。

通过设置筛选条件,以小时或天为单位呈现统计报表。

按天聚合数据、按小时聚合数据结果展示(经开发解释,“聚合”是“统计”的意思)。

以小时或天为单位呈现统计报表。

右上角筛选条件说明。

设置筛选条件。

支持根据多个模板名称筛选指定发送时间的某个模板名称业务統计数据。

可查询指定发送时间内,特定模板相关的业务统计数据。

 

Part2 文理背景有区别

 

很多大公司的文档员只会输出技术,其实写出来的文档不具备可读性,整个团队也没几个会写文档的,最终呈现的交付物看完让人忍俊不禁。下表展示了理科生和文科生在行文码字上的区别:

如何说"我爱你"

理科生

文科生

我养你啊!

不思量,自难忘。

                       ——苏轼

那一刻,我很暖。

                       ——王家卫

今晚月色真美。

                        ——夏目漱石

假如有人问我烦扰的缘故,我不敢说出你的名字。

                                                                     ——戴望舒

我对你根本没抱幻想,我知道你愚蠢、轻佻、头脑空虚,然而我爱你;

我知道你的企图、你的理想,你势力、庸俗,然而我爱你;

我知道你是个二流货色,然而,我爱你。

                                                                                                                                                                            —— 毛姆

f5fa5f71679149deb4487e0b1a6ad382.png

 

最后的话

 

在写作方面,理科生注重数据和事实,以及科学性的表达,忽略了语言的美感和流畅性。文科生的写作更加注重语言的美感和艺术性。

 

没有人是十全十美的,理科生可以走出舒适区学习如何行文和表达。文科生也没必要妄自菲薄,看到理科生的长处,学习相关领域技术。

 

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值