SIX LINES · 480+ DOCS · BIWEEKLY SYNC

产品线帮助文档
从入口到那一页

六条产品线的使用说明都收在鼎盛平台产品线帮助文档里。您刚接手一个团队账号,或者正卡在一条调不通的接口上,先按产品线锚定,再顺着深度往下读,两三步之内就能拿到能照着做的操作步骤。

01

六条产品线,先认准手上这一条

每条产品线的文档都在解决一类具体麻烦。看清自己卡在哪一类,后面的检索会快很多。

01

账号与身份

成员入职离职、角色与权限分配、单点登录对接,都落在这条线上。权限配错导致看不到菜单,是最常见的求助。

常看的人:IT 管理员

82 篇

02

内容协作

多人同时编辑、历史版本回溯、审批流怎么串起来。稿子被谁改过、怎么退回上一版,这里都有步骤。

常看的人:业务负责人、内容运营

96 篇

03

数据看板

指标怎么定义、图表怎么搭、报表怎么定时推到同事邮箱。数字对不上时,先从指标口径那几篇查起。

常看的人:运营分析、业务主管

88 篇

04

开发者工具

接口鉴权、回调地址、沙箱联调与错误码对照。第一次接通的完整链路,从一个可以跑通的最小请求讲起。

常看的人:研发工程师、集成方

74 篇

05

移动端体验

手机上怎么审批、离线时能看到什么、小屏排版如何收成单列。外勤同事的第一手问题多集中在这里。

常看的人:一线外勤、移动办公人员

62 篇

06

服务支持

工单怎么提、响应时长怎么算、培训和迁移如何预约。遇到跨产品线的问题,从这里找对接人最快。

常看的人:客服主管、运维人员

78 篇

六块扁平几何模块按网格排列,用深浅不同的蓝色区分六条产品线,中心是一个青色入口点
六条产品线共用一套账号体系,文档也从同一个入口进入,不必分别登录。

02

同一篇文档,读多深由您定

480 余篇说明按四个深度层级摆放。知道自己在哪一层,就不用从头翻到尾。

入门 148 篇

讲清一个概念是什么、第一个流程怎么跑通。刚接手项目、要给同事做交接时,从这一层开始最省时间。

进阶 132 篇

把常用能力串起来用:模板复用、批量处理、多人协作的分工方式。已经上手、想提效率的人看这一层。

配置 116 篇

权限、字段、通知规则、接口地址这类设置项的逐项说明。改动会影响整个团队时,先对照这里再动手。

排障 84 篇

按报错现象组织:先看日志在哪、再看错误码怎么读,最后给对应的处理办法。运行中出问题先翻这一层。

四级阶梯状抽象图形,颜色由浅青逐级过渡到深海蓝,表现由浅入深的阅读层次
四个层级不是先后必读顺序,而是按您当下的问题深度选一层进入。

03

目录式与全览式,两种读法随时换

鼎盛平台大陆版页面在正文上方提供一枚切换控件,点一下就在两种排版之间换过来,当前读到哪一篇不会丢。

MODE / TOC

目录式:知道要找什么,直接下钻

左侧常驻一列层级目录,点开一级展开二级,正文区只显示当前这一篇。目录的展开状态和滚动位置会保留,来回比对两篇参数时不必反复往回找。

适合已经明确问题、要照着步骤边做边看的时候。比如配置单点登录,您需要的是那一篇参数说明,而不是整章通读。

MODE / ALL

全览式:第一次接触,先通读一遍

整章内容按标题层级平铺在一页里,一屏接一屏往下滚。浏览器自带的页内查找在这里特别好用,搜一个关键词就能看到它出现在哪些段落。

适合新人交接、内部培训投屏,或者您想把一条产品线的能力全貌过一遍。一个地址就能把整章讲完,转给同事也方便。

目录式与全览式两种阅读布局并排示意,左侧带侧栏目录,右侧为通栏平铺的正文
两种模式指向同一批内容,切换后仍停在原来那一段。
分层级的抽象架构图,顶层为统一入口,向下分出产品线栏目与具体文档节点
入口只有一个,往下依次是产品线、层级、具体篇目,深链接可以直接发给同事。

04

在手机上照样读得下去

从 2022 年起,移动端体验专项已经做了 6 轮全站适配改造。现场用手机查步骤、临时给客户演示,都不必再回办公室开电脑。

  • 单列到底窄屏打开时正文收成一列,左右各留 20 像素边距,图片按屏宽缩放,不用来回横拉。
  • 好点得中切换模式、展开目录、复制参数这些控件都不小于 44 像素,戴着手套在户外也点得准。
  • 长表格横着看参数对照表在小屏上向右滑动查看,第一列固定在左侧并带一条青色边线,滑到哪都知道在看哪一行。
  • 断点不丢进度手机上看了一半的章节,回到电脑上从同一个地址打开就能接着往下读。
扁平渲染的手机设备示意图,屏幕内为单列排布的文档结构,控件间距宽敞
手机上的排版不是把电脑版缩小,而是按单手操作重新排过。
不同文档类型的建议读者、平均阅读时长与更新频率
文档类型 建议读者 平均读完 更新频率
入门指引 新加入的成员 8 分钟 随双周版本
配置手册 团队管理员 15 分钟 随双周版本
接口参考 研发与集成方 20 分钟 版本发布后 3 日内
排障清单 运维与客服 6 分钟 按实际案例补充

05

功能改了,说明跟着改

小版本每两周迭代一次,文档与功能在同一天上线,最近一次是 7 月 10 日版本。您照着文档操作时,看到的就是当前版本的界面。

  1. 01

    三方对照

    每一篇上线前,产品、文档、测试各查一遍:界面是否一致、步骤能否复现、边界情况有没有写漏。

  2. 02

    随版本发布

    功能上线当天,相关篇目同步更新;涉及权限或字段的改动,会在篇首标出影响范围。

  3. 03

    公告留痕

    重要变更写进内容中心的双周公告,注明涉及哪条产品线、改了哪几篇,方便您回查三个月前的说法。

  4. 04

    纠错闭环

    发现写错或过时,从篇目底部的纠错入口提交即可,平均 3 个工作日内处理完毕并回复处理结果。

检索参数示例
line    = 数据看板
level   = 配置
keyword = 指标口径

把这三个条件一起用上,通常一两条结果就能命中。参数写法在各条产品线里保持一致,记住一次就能通用。

06

按您的角色挑一条起点

同一套文档,不同角色关心的部分差别很大。下面三条路线是大多数人验证过、见效最快的顺序。

NEW USER

刚接手的新成员

  1. 账号与身份 · 入门:先弄清账号从哪来、能看到哪些菜单
  2. 内容协作 · 入门:跑通第一次编辑、提交与发布
  3. 移动端体验 · 入门:把常用操作搬到手机上

大约两小时能读完这三组,够应付日常操作。

ADMIN

负责配置的管理员

  1. 账号与身份 · 配置:成员批量导入、角色与权限模板
  2. 数据看板 · 配置:指标口径统一、订阅推送设置
  3. 服务支持 · 排障:工单分级与响应时长的判定方式

改配置前先看一眼进阶篇,能避免大半的返工。

DEVELOPER

对接接口的开发者

  1. 开发者工具 · 入门:鉴权方式与一次最小可用请求
  2. 开发者工具 · 配置:回调地址、重试策略、沙箱联调
  3. 开发者工具 · 排障:错误码含义与日志定位路径

沙箱环境和正式环境分开跑,联调阶段不容易踩坑。

三条路线之外的具体问题,可以在使用答疑里继续按场景查找,也可以直接联系我们。

翻了三篇还没对上号?

把您正在做的事说一句,工作日的咨询一般在 24 小时内得到回复。文档里没写清楚的场景,也是我们最想补上的部分。