T3.01.3Intent-scoped documentation sections设计研究

一节回答一个问题

别名: 一节一问 · 用户意图 · 章节粒度 · deep-linkable answer unit

概念解释

以意图界定的文档小节(intent-scoped documentation sections)让每节兑现一个可命名的问题或用户意图:标题预告读者能解决什么,正文提供完成该意图所需的答案。“一个问题”不是只能有一个事实或一段文字;复杂问题可以包含前提、原因、步骤、例外和子问题,只要它们共同服务同一意图,并通过子结构让读者定位。

标题也不必都写成问号句。任务式或主题式标题只要能与真实查询匹配、与相邻章节区分,并由正文兑现,同样可以形成清楚的问答契约。

机制

搜索结果、目录和深链通常指向小节而非整篇叙事。若一节混合多个无关意图,搜索摘要可能命中一个词却把人送进大量无关内容;若一个意图被任意切散,读者又必须在多个落点间拼装答案。以意图确定边界,使标题、搜索索引、锚点和正文共享同一个检索单位,并让直接进入页面中部的人知道自己到达了什么。

复杂问题存在依赖关系。排错可能同时需要症状、原因、验证和修复;迁移可能需要前提、执行与回退。这些不是自动拆成四个互不相连的节,也不是堆成没有层次的大段。父节声明总问题,子标题承载可独立命名的子意图,必要前提在落点附近摘要或链接,从而兼顾整体答案与局部检索。

怎么研究

从搜索日志、支持请求和任务访谈中建立“查询—意图—目标小节”样本,要求参与者从搜索、目录或外链直接进入并解决问题。记录首次落点、答案完整性、在同页与跨页的往返、继续搜索、错误执行和任务结果;退出页面不能直接解释为满意,需要询问答案或观察后续行为。

比较合并、拆分和父子结构时,保持事实内容不变,并纳入含前提与例外的复杂任务。移动端测试落点后的标题可见性、折叠内容和上下文;读屏测试标题层级、目标焦点、前提链接名称及返回位置。搜索词分布会受现有标题影响,不能只用当前查询日志证明当前章节结构正确。

边界

参考资料常按对象、命令或参数组织,一张表可能同时支持多个查询;只要对象边界稳定、字段有语义,这不需要伪装成一个问题。概念论证也可能需要跨节累积,直接落点应标出必要前提,但不必在每节复制整篇背景。法律、安全或高风险流程不得为了小节“自足”而删掉适用条件或把整体后果拆得不可见。

章节长度和屏数不是判断标准。一个简单意图可能只需一段,复杂意图可能需要多个子节;只有当子问题可以独立命名、搜索和理解时才拆分。拆分导致大量重复,或迫使读者来回拼接同一决定时,应保留在共同父结构中。

怎么落地

  • 为每节维护一个意图契约:目标查询或任务、承诺的答案、必要前提、例外、可独立搜索的子意图、所有者和版本。无法用一句内部陈述命名的节,重新划界而不是机械删短。
  • 让标题采用用户会寻找的任务或概念语言,并在开头给出直接答案或路线。复杂问题用父标题总览、子标题分解;前提影响安全或正确性时,在深链落点附近摘要并链接完整说明。
  • 给每个稳定意图分配不随显示标题和语言直接变化的锚点标识。标题改名、拆分、合并或版本迁移时维护旧深链到最接近答案的重定向,并同步搜索索引和摘要。
  • 在桌面、移动和读屏上用真实查询直接落地验证:用户应能命名当前问题、取得完整答案、识别前提并返回原路径。监控同一查询的连续搜索和跨节往返,但用任务成功确认原因,不把离开页面自动算作解决。

延伸

  • 同组T3.01.1 用户扫描而非通读文档 · T3.01.2 标题、列表与代码块承担扫描锚点
  • 相邻T3.02.1 帮助应按用户任务而非功能模块组织 · T2.02.2 创意性标题损害可预测性
  • 站内检索section granularity · user intent · deep-linkable answer unit

同组卡片

快捷操作

分享

分享当前页面

ios_share

https://hci.top/zh/handbook/T3.01.3