文档索引:先读哪一篇,读完接着看什么

文档类资料一共 6 条主题,编号 DOC-01 至 DOC-06,按阅读的必要程度分成核心文档与延伸阅读两组。

银河总站的资料库按用途把站内资料分成五类,合计 11 条资料条目;文档是其中偏结构与说明的一类。父页回答的是「有哪些类型的资料、各自适合谁」,到了这一页,问题换成「文档有哪些主题、哪一条先读、读完之后接哪一类」。如果连自己该看文档还是该看术语对照都还没确定,可以先回到资料库的分类清单做一次判断。

六条主题之间的先后关系不是等级,而是依赖:讲结构的条目读完之后,讲检索的条目才有意义;反过来先读检索说明也不会出错,只是会少一层背景。

展开的星图坐标与细网格,方形节点标出文档条目所在的目录层级
展签:横轴是目录层级,方形节点是文档类条目所在的位置,节点之间的距离表示阅读顺序上的间隔。

两组之间只有一条判断标准

核心文档 · 延伸阅读

划分标准只有一句:不读它,会不会妨碍你展开内容中心的目录。会妨碍的进第一组,只在特定情形下才用得上的进第二组。

核心文档

DOC-01 — DOC-03

属于进入站点的必要前提:内容中心怎么构成、导航怎么读、检索怎么用。第一次到访的人从这三条开始,读完就能自行定位到任意栏目,不必再回头问入口在哪。

三条之间有明确顺序:先结构,再导航,最后检索。顺序颠倒不影响理解,但会在中途反复回查前一条。

延伸阅读

DOC-04 — DOC-06

有具体触发条件才需要翻:换设备阅读、核对某条编号或字段、追查某一期改了什么。如果你的目标只是找到某条内容,这三条可以先放着。

它们都不是前置条件。跳过延伸阅读不会影响任何其他条目的阅读,也不会让你漏掉结构信息。

判断是否该回头补读延伸阅读,看一个信号就够:当你在两处看到同一个说法却对不上时,直接翻 DOC-05;当你需要确认某个版本改动时,直接翻 DOC-06。

六条文档主题

编号 · 范围 · 适用对象 · 篇幅档位 · 状态

条目默认展开,点标题行可以收起其中一条,方便把两条主题并排对照着看;键盘同样可以到达每一行的展开控制。

内容范围
九个公开页面的分布、三级目录的层级关系、累计 386 条公开条目的归类方式,以及编号是怎么生成的。
适用对象
第一次到访、想先弄清站点从哪里展开的人;也适合需要向别人转述站点结构的人。
篇幅档位
长档。建议在宽屏上一次读完,中途不要跳读层级表。
更新状态
随第 3 期复核,结构调整段落已同步。
相邻主题
DOC-02 讲完整体之后接着讲导航怎么读。
内容范围
左右分置导航为什么这样排、分组索引里的方形节点代表什么,以及宽屏与窄屏默认展开和默认收起的差别。
适用对象
在目录里反复找不到入口的人,以及不确定某一项该归到哪个栏目的人。
篇幅档位
中档。读一次即可,遇到目录变化时回来核对。
更新状态
常设条目,不随期次改动;端侧调整时另在 DOC-04 补记。
相邻主题
DOC-01 提供层级背景,DOC-04 解释两端的差异。
内容范围
标题、关键词、条目编号三种查法的差别,六个检索分区各自负责什么;索引共收录 1,240 条条目,输入即在本页过滤,命中行会换底色。
适用对象
已经知道要找什么、只想快速定位到某条内容的人;也适合习惯用编号而不是关键词的人。
篇幅档位
短档。一屏内可以读完,边用边看即可。
更新状态
随第 3 期同步更新索引条目与分区说明。
相邻主题
DOC-05 编号查不准时用它校正字段含义。
内容范围
电脑端与移动端在排版、目录展开方式与默认折叠状态上的不同,以及两端条目内容一一对应、不做增删的事实。
适用对象
习惯在手机上翻条目的人,以及需要在两种设备之间对照同一栏目的人。
篇幅档位
中档。只看自己常用的那一端即可,不必两端都读完。
更新状态
常设,端侧版面调整后单独补记,不并进其他条目。
相邻主题
DOC-02 折叠状态与导航规则是同一套逻辑的两面。
内容范围
编号列、分组标签、状态标记与期次字段各自的含义,以及怎样用它们核对同一说法在两处是否一致。
适用对象
需要引用具体条目的人,以及在意数字前后是否对得上的谨慎型访问者。
篇幅档位
中档。对照表部分建议横向读完一行再往下。
更新状态
条目措辞调整后同步,本次已随 11 条措辞修改一并更新。
相邻主题
DOC-03 教你找到条目,DOC-06 解释条目的变动记录。
内容范围
修订以期为单位的滚动方式,每期覆盖结构、条目、措辞三层;第 3 期调整了 3 处栏目结构与 11 条条目措辞。
适用对象
回访读者,以及想确认早先看到的口径是否仍然成立的人。
篇幅档位
短档。每期只看新增的那一段就够。
更新状态
每期滚动更新,与当期发布同步。
相邻主题
DOC-05 改动落在哪个字段上,由它解释。

三条阅读路径

首次阅读 · 查漏补缺 · 版本对照

六条主题 首次阅读 查漏补缺 版本对照

首次阅读

适合还没建立站点结构印象、连入口层级都还没分清的人。

  1. DOC-01
  2. DOC-02
  3. DOC-03

走完这条线,目录能自己读,检索能自己用,不再需要回头找入口。

查漏补缺

已经知道要找哪条内容,只是叫不准编号写法或字段含义时走这条。

  1. DOC-03
  2. DOC-05
  3. 回到检索

先确认查法,再校正字段,最后回检索板块实际用一次,比通读整页更快。

版本对照

回访时想确认这一期动了什么、旧口径是否还成立时走这条。

  1. DOC-06
  2. DOC-05
  3. DOC-01

从改动记录出发,回到字段含义,再回到结构层级,顺序反着读也可以,只是核对次数会多一些。

三条分叉细线路径,节点为方形,无人物
展签:三条路径从同一组六条主题出发,末端分别停在不同编号上;路径之间没有先后,只有触发条件不同。

读完文档之后

相邻资料类型与返回入口

文档只覆盖结构与说明。若要确认某个词在站内的统一写法,转去看术语对照;若想知道某条内容是在哪一期改动的,转去看版本记录;若是高频疑问的集中答复,转去看常见问题汇编。这三类与文档并列,入口都在资料库同一层,不需要重新找路径。

文档自身的发布节奏不写在文档里,而在活动公告的时间线上:每一期如何发布、如何校验、出现偏差如何回滚,都归在更新机制那一组节点。资料板块能覆盖到什么程度、哪些请求不在其列,写在业务范围的「资料与支持」分组。需要有人回话时,邮箱与服务电话见联系品牌页。