对文档的撰写新的领悟:简洁,清晰

文章描述:写文档的一些技巧.

最近带一个毕业生,他让我对文档的撰写有了一些新的领悟,跟以前的结合起来一起说一下:

首先,我个人在写文档方面有2个特点:简洁,清晰

简洁:能用一句话说清楚的绝不用第二句,用最简单的句子

清晰:结构清晰,让人一目了然;逻辑清晰,尽量减少读者的理解成本;重点清晰。

对内的文档

对上级:由于上级的时间都很宝贵,所以对上级的文档建议使用“金字塔原理”(《金字塔原理》是一本很不错的书,推荐阅读)。先用简练的开头让老大知道整个文档的核心内容(分析结果、方案概述…),然后再阐述细节,说明理由。

对下级:大部分都是执行层面,所以文档要强调执行的目的,完成时间,谁来做,做到什么程度,需要注意什么…

跨部门:大部分都是需求类文档,要强调制作需求目的,需求实现的各种细节,测试时间,更新时间…

对外的文档

对于活动策划来说,对外的文档主要就是活动公告了,这也是今天想说的重点。

【结构】

活动标题、活动引言、活动时间、活动范围、活动奖励、活动内容、活动说明。

这几个部分缺一不可,顺序没有定式,始终如一即可。由于大部分活动文档都是用这种结构,所以制作一个活动文档的模板是十分有必要的,能够节省很多时间。

【重点】

语言简洁,不说废话,同时要突出重点跟。跟玩家参与活动有关的都是重点(5W1H),这些重点尽量用颜色区分,但是不同的颜色不要过多,多于3种以上的颜色就很难看。

我一般在奖励(红色)和NPC(蓝色)上用颜色区分,时间由于是独立的一部分所以不用颜色。

【逻辑】

大部分活动都没有很复杂的逻辑(如果大部分活动的逻辑都很复杂,那么这个活动策划就是失败的,他的活动方案“拦住了”很多玩家参与活动),我们可以是用上面的结构。

但是有时候因为某些功能无法实现,或者为了增加乐趣性,我们选择了较复杂的活动逻辑和流程。这个时候,使用上面的结构就不是明智之选了。当你按照上面的结构写完,让一个不了解活动的同事来瞅瞅,发肯定会告诉你:第一他不愿意看,因为字太多,第二他不容易看懂,因为活动内容和活动说明这2个部分的逻辑会错综复杂。

面对较复杂的活动,我建议使用玩家的行为逻辑。目的都是为了让玩家知道“我要做什么”!

活动概述:

最简洁的语言说明活动的核心内容,活动奖励,活动范围。(同样是金字塔原理)

流程图:

图形化的手段降低理解成本。流程图中的内容为玩家行为(如果活动流程中存在官方人员的工作内容,去掉它,只保留玩家必须要知道的内容)

流程详情:

每一步流程都包括时间,内容,其他说明。

【修饰】

加入活动奖励图片:把奖励的文字标红,远不如加入奖励图片来的好。

加入跟活动主题贴切的图片:这个图片是用来传递情感的,比如在母亲节活动的公告中加入一张体现关爱母亲的图片能更有感染力。

活动引言:以前我最不爱写这部分,但是现在觉得这个引言也很重要,因为他体现了一种风格,就跟人的个性一样,这部分文字能让突出游戏的风格特点。比如你是一个三国背景的游戏,引言就可以加入一些典故。

不要觉得图片一定比文字好:以前我曾迷信图片一定优于文字,所以有一阵尝试了在所有的活动公告中都加入一些流程图(包括逻辑简单的活动),但是发现图片无法精确的表达细节,容易误导玩家。所以简单的活动不要用图片,加入图片反而变得复杂化,复杂的活动再加入流程图。

【当局者迷】

由于活动方案都是我们想出来的,整个活动都是我们自己的逻辑,所以我们不存在理解问题。

另外,做方案时,我们会设计好玩家的行为方式,其他行为方式可能会被我们所疏忽。

基于以上2点原因,我们写出来的文档可能会让玩家难以理解。所以我们在写好文档后,最好找一个对活动方案不了解的同事,让他看一遍,是否存在理解困难问题,或者哪些地方玩家可能钻空子。

听取局外人的意见,对文档进行最终修改,这样的文档才能成为玩家喜欢的文档,而不是我们自己喜欢的文档!

时间: 2024-10-04 07:22:35

对文档的撰写新的领悟:简洁,清晰的相关文章

添加标签-MFC多文档如何添加新的文档页

问题描述 MFC多文档如何添加新的文档页 要添加两个标签,之前一直是在CChildFrame中调用OnCreateClient来进行窗口拆分的,如果不想拆分窗口的话应该怎么写,调用哪个函数 解决方案 MFC多文档的创建和打开过程 解决方案二: http://zhidao.baidu.com/link?url=qC-ksJhheAv4_3WTo9_foHre2fdSdmcwL6FvGQjpgyGm50PqAaQFzV0gpj2kh5UF95WJ97UzDZuD453msrImbq 类似这个? 解决

mfc-MFC多文档程序怎么用文档指针创建新的视图

问题描述 MFC多文档程序怎么用文档指针创建新的视图 多文档程序最上面有一个系统的新建.打开.保存等按钮,我想在mainfrm里一个按钮重新"实现"打开这个功能,我可以获得文档的指针,但是怎么用获得的这个指针来为它创建一个视图呢 解决方案 如何在MFC单文档中创建多视图如何在MFC单文档中创建多视图MFC多文档程序启动时一个文档创建两个视图 解决方案二: 参考打开的代码CWinApp::OpenDocumentFile

如何在Word文档中添加新的字体?

  我们经常能看到别人精心编辑的Word文档或图片有着非常好看的字体,这样给整个文档或图片增色不少,往往能起画龙点睛的作用.那么Win8系统下我们如何安装个性化的字体呢? 首先可以在百度.360搜索等平台搜索"字体下载 ",然后就可以找到很多字体下载网站.字体安装到电脑其实非常简单,只要将下载的格式为*.ttf格式或*.fon格式文件拷贝到C盘的的字体文件夹中就行了. 具体位置在:本地磁盘C:windowsfonts (注:系统如果安装在D盘,那就是进入D盘哦). 其次安装后,我们可以

SharePoint 2016 文档库的新功能简介

今天,重装了一下SharePoint 2016,想多了解了解,看到一些自己平时没注意的功能,或者新的功能,分享一下给大家. 1.界面上操作的变换,多了一排按钮,更像SharePoint Online了,呵呵:这一排按钮可以新建.上传.同步.共享等操作: 2.共享功能的界面有了新的变化,看起来更加简洁了,把查看权限和邀请分开了,如下图: 2013中界面: 2016中界面: 3.多了打开链接在移动设备,我们可以点击这个按钮,然后出一个二维码,用移动设备扫面就可以了,很有意思的功能: 4.打开文档在移

【心得分享】关于MarkDown文档的撰写

问题描述 **为什么要用 MarkDown 写文档**最开始接触 MarkDown 其实是在研究各种 Wiki 系统时看到的.因为不明白 MarkDown 是什么东东,所以就手贱的搜索了一下.然后,本能地学习它的语法结构.刚上手时,感觉相当不习惯.从我的个人感受来说有以下几点:不熟悉 MarkDown 的语法,总是要查手册.(又要记好多东西啊--)没有好用的工具,和语法高亮.(和 txt 看着差不多--)没有所见即所得来的方便.(还不如 Word 嘛--)接受 MarkDown 是在观察了 Gi

Google新推Docs Viewer 在线阅读所有文档

中介交易 http://www.aliyun.com/zixun/aggregation/6858.html">SEO诊断 淘宝客 云主机 技术大厅 Google Docs团队近日上线了一项新服务Google Docs Viewer,用户可以通过浏览器直接阅读Adobe PDF.微软Word.PowerPoint等文件,无需再将文件下载到计算机上.当然这种服务并不是首创,比如说Firefox的插件Open It Online也提供类似的功能,不同的是Google Docs Viewer布局

写有价值的技术文档

背景 传统瀑布开发模式下非常重视文档,每个开发环节的衔接都通过文档实现.这种重视在CMMI达到了极致,软件开发的每一步从形式到内容都要求文档化,需要设计者花费大量的精力在文档的撰写和维护上.高度文档化需要投入巨大的成本,这种成本在相对固定,变化较少的问题域(如传统的制造.管理)可以从软件后期的维护收益上得到补偿,实践中也得到了较好的效果.但在变化较多的问题域(如互联网.创业企业),高度文档化会造成整个软件生产过程的反应迟滞,进而造成企业竞争力的下降.于是这些要求快速反应,快速迭代的行业逐步放弃了

如何在Web页面上直接打开、编辑、创建Office文档

web|创建|页面 有朋友询问如何在Web页面上做到像SharePoint中的效果一样,能直接激活客户端的Word来打开.doc文件,而不是类似直接点击.doc文档链接时Word在IE中被打开那样.想想这个问题应该很多人都会感兴趣,所以干脆写一篇blog来大致描述一下方法. 在安装Office2003以后,有一个ActiveX控件被安装到了系统中,这个控件位于"Program Files\Microsoft Office\OFFICE11\owssupp.dll".通过这个控件,客户端

定制SharePoint文档信息面板

作为SharePoint内容管理功能的一个具体表现,文档信息面板(Document Information Panel)的功能,使得我们在使用文档并且将其用于工作流程的时候 ,可以添加一些与业务相关的数据. 文档信息面板,是SharePoint服务器结合Office 客户端软件共同实现的一个 功能. 默认的文档信息面板 只要在文档库中,添加至少一个自定义字段,然后通过Office客户端软件( 例如Word)为该文档库添加新的文档的时候,就会自动显示出文档信息面板. 下面的例子中,我有一个文档库,