如何编写帮助文档

编辑
文档创建者:传说哥 (55549 )     浏览次数:1400次     编辑次数:0次     

目录:

1、创建/编辑文档编辑

1)在顶部,有个绿色的“创建文档”按钮,点击后即可开始创建

2)创建之前请点击分类查看同类文档是否已存在,或使用搜索功能来确认

3)若文档已存在,但需求完善,可以点击“编辑”按钮

编辑完成后,点击发布。如果是编辑的已有文档,需要填写详细的修改原因,这样才能更容易通过管理员审核。

文档通过审核会自动获得积分。点击自己的用户名可以查看到自己创建和编辑过的文档。

2、文档编辑器编辑

以下是编辑器图标功能说明

源代码:一般不需要用到,如果需要的话可以点击切换至html源代码模式查看或编辑

一级目录:例如本文档,选中一级目录名称后点击即可,文档开头会调用一级目录的锚链

二级目录:例如本文档,选中一级目录名称后点击即可,文档开头暂时无法调用二级目录名,后面会进行改进

路径:例如%FR_HOME%\WebReport\WEB-INF\reportlets\doc\Advanced\Chart\NewColumnChart\AxisCustom2.cpt

公式:例如CNMONEY(1200)等于壹仟贰佰圆整。

警告:例如备注:单位可以为空,如果为空,则直接将number转换为人民币大写,否则先将number与单位的进制相乘,然后再将相乘的结果转换为人民币大写。

目录:例如插入>单元格元素>插入图表

SQL:例如=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO = 'Class1' ",3,4)

图片:点击后选择图片上传,暂不支持调整大小,请在本地将图片调整为合适大小

链接:选中文本点击或者直接点击即可插入。

          注意:   ①复制粘贴网址的时候如果已含http抬头,需要去掉一个;

                       ②如果是要在文档内打开连接,就选择在本窗口,如果是要跳到别的网站,就选择默认的在新窗口打开

特殊符号:点击即可插入

表格:点击选择行列数目即可插入

视频:点击即可插入链接,鉴于优酷等有广告,可以将视频放置到我们的云服务器上,具体联系传说哥(微信ID:frbiaoge   QQ:2851322998)

代码:点击即可插入

3、文档分类编辑

文档写好后需要确认在哪个分类中,如 报表应用 >> 报表FAQ >> 空指针错误;
若当前文档没有这个分类,需要创建一个新的分类。请联系@Susie(qq:2851322841)

4、标题编辑

标题能否与搜索的问题一致/匹配。
1) 指南类和有关怎样做的文档:如何得到这样的结果?(例如:以图片显示内容)
2) 参考类的文档:功能/特性的名称?(例如:相邻连续分组)
3) 故障解决类的文档:我遇到的问题。(例如:安装设计器后无法预览报表)

5、描述编辑

描述,和标题一样重要,能帮助阅读者快速地确定这篇文档是否是他们所需要的。
1) 指南类的和有关怎样做的文档:给出文档中需要的知识的大致摘要。
2) 参考类的文档:给出功能/特性的简单解释。
3) 故障解决类的文档:给出故障的大致描述以及现象。

6、怎样编写一篇文档编辑

1) 提供问题发生的环境(FR版本、操作系统、浏览器、服务器等)。
2) 确保完成任务所需的每个步骤都被包含。
操作步骤采用可以用列表的方式还原,如用1)、2)、3)…数字序号标注。
3) 文档编写力求简单明了,如有需要,配以适当的图表,以增强清晰性。
4) 不要用太口语化的文字,写完文档后,用初学者的眼光看一下文档,确认以新手的身份能否看懂。

7、参考模板编辑

7.1通用问题

某种通用问题示例,具有一定代表性,可重复性

文档标题
1) 问题描述
2) 实现思路
3) 示例/操作步骤
(详细的操作步骤,阅读者根据示例,能够完整的还原出编写者要的示例;包含截图,超级链接,代码等)
4) 保存并发步
需要附上文档中演示的Demo模板(且模板能正常使用、代码能正常运行)

7.2故障类解决方案

文档标题
1) 问题描述(描述故障现象,根据描述能重现/还原故障,附上报错截图
2) 原因
3) 解决方案
详细的操作步骤,确保完成任务所需的每个步骤都被包含,如果有模板需要提供模板

8、文档编辑流程编辑

假设文档A目前最新版本是3,简称为A3,所有人都可以浏览A3,所有非违规用户都可以编辑A3;
一旦有用户编辑了A3发布了A4版本,比如这人是甲。那么甲和管理员看到的是A4,而其他人看到的依旧只是A3版本。且甲可以继续编辑发布,其他人都不能进行编辑,编辑发布后依旧是A4版本。
等到管理员审核批准A4后,其他普通用户和游客才能看到A4,以及编辑文档A4。 

附件列表


主题: 快速入门
标签: 暂无标签 编辑/添加标签
如果您认为本文档还有待完善,请编辑

文档内容仅供参考,如果你需要获取更多帮助,付费/准付费客户请咨询帆软技术支持
关于技术问题,您还可以前往帆软社区,点击顶部搜索框旁边的提问按钮
若您还有其他非技术类问题,可以联系帆软传说哥(qq:1745114201

本文档是否有用?