关于本站的技术口径说明
这一页说明本站的内容定位:把 mk官网中国官网 相关信息按技术文档的方式整理成可检索的页面,而不是把同一段话反复搬运到每个栏目。整站以字段命名、分区标签和页面分工为骨架,读者遇到疑问时可以先在这里确认阅读方式,再进入具体页面。
作为一份公开的 mk官网官方 口径说明,本站不写具体数值、不写渠道承诺、不写无法核对的细节;正文只描述内容怎么组织、入口怎么走、字段怎么读。凡是需要实时确认的部分,都交给站内对应页面承接。
内容怎么组织
全站页面按功能分工:首页承担总览与检索,产品页展开技术模块,资讯页保留长文摘要与条目列表,联系页承接说明与反馈,专题页集中赛事与客户端口径。页面之间的链接只在需要互相印证时出现,不做无意义的交叉跳转。
分区标签统一使用等宽字体,字段命名在各页保持一致;同一个概念只保留一种叫法,读者把某一段复制给他人时,对方也能在站内找到对应位置。
每个分区的开头都会先用一句话说明这一段的适用范围,再展开细节。如果一句话说不清范围,说明这一段还需要拆分,而不是继续堆内容。
话写到哪里为止
技术说明的边界很清楚:凡是能稳定复述的内容写进正文,凡是会随时间改变的内容只留口径与入口。这样处理之后,页面不需要频繁改写,读者也不会因为旧描述与新描述并存而困惑。
涉及赛事与数据的段落,只写来源类型、字段位置与刷新方式的说明方式,不写具体数字;示例面板中的文字用于演示排版,界面示意,非实时数据。
如果某个说法需要靠具体数值才能成立,那么这个说法就不写进正文,而是指向站内对应页面,由读者按入口自行核对。
页面怎么互相引用
引用规则有两条:一是引用方必须说明为什么引用,二是被引用方必须能独立读懂。这样即使读者只打开其中一个页面,也不会因为缺少前文而看不懂字段含义。
入口类的引用统一收敛到导航与页脚,正文里的链接只用于补充说明,不承担导航职责;同一段落在站内只会有一个主要出处,其余位置以一句说明加链接的方式指过去。
当两处说明出现出入时,以分工更细的那个页面为准,并在反馈中写明两个页面的名称与段落位置,方便一次性核对。
推进阶段
站点的整理工作按四个阶段推进,每个阶段只解决一类问题,阶段之间不做跳跃。以下只写阶段名称与工作内容,不涉及任何时间点。
-
STAGE-FRAME
搭骨架
确定页面分工与分区顺序,先把目录结构与字段命名定下来,再往里填内容。
-
STAGE-DRAFT
写正文
按分区逐段撰写技术说明,每段先写适用范围,再写细节,长度以讲清一件事为准。
-
STAGE-UNIFY
统一口径
逐页核对同一概念的叫法与字段顺序,把重复描述合并到主要出处,其余位置只留一句指引说明。
-
STAGE-REVIEW
复核入口
检查每个入口是否都指向站内页面,确认导航与页脚没有多余跳转,再交由读者反馈修正。