信息架构（Information Architecture, IA）是对信息进行组织、结构和标注的艺术与科学。在技术写作中，好的信息架构让读者"找得到、看得懂、用得上"。如果说内容是血肉，信息架构就是骨架——骨架不正，肉再好也站不起来。信息架构决定了读者在你的文档中能否高效地找到所需信息。
信息架构是文档的骨架。骨架不正，肉再好也站不起来。
决定信息如何分组和分类。选择正确的组织方式，是信息架构设计的第一步。组织方式直接影响读者找到信息的速度和准确度。错误的组织方式让读者像走迷宫一样在文档中寻找信息。
| 组织方式 | 适用场景 | 示例 | 优缺点 |
|---|---|---|---|
| 按任务 | 操作型文档 | "创建项目" "部署应用" "监控服务" | 任务导向，但不同任务可能重复信息 |
| 按主题 | 参考型文档 | "认证" "数据库" "缓存" "队列" | 逻辑清晰，但需要读者知道主题名 |
| 按受众 | 多角色文档 | "用户指南" "开发者文档" "运维手册" | 读者导向，但维护成本高 |
| 按时间 | 流程型文档 | "入门" "进阶" "高级" "专家" | 适合学习路径，但非线性需求难处理 |
| 按字母 | 索引/词汇表 | 术语表、API索引 | 查找快速，但缺乏上下文关系 |
决定如何命名和描述信息。标注直接影响读者的理解和导航效率。一个好的标注让读者一看就知道这段内容是不是自己需要的。模糊的标注是信息架构中最常见的问题之一。
# 标注对比：同一功能的不同命名
模糊标注 ──────────── 精确标注
功能说明 → REST API 参考
设置 → 通知偏好配置
帮助 → 故障排除指南
更多 → 高级配置选项
其他 → 插件市场决定读者如何在信息间移动。好的导航让读者始终知道自己在哪里、要去哪里、怎么回去。导航系统是信息架构的"交通网络"——路标不清，再好的路也会走丢。
# 多层级导航设计
全局导航：首页 | 文档 | API | 博客 | 社区
│
├── 面包屑：首页 > 文档 > 部署 > Docker部署
├── 侧边栏：当前章节的子页面列表
├── 上一页/下一页：线性阅读导航
├── 相关链接：交叉引用
└── 搜索：全文检索决定读者如何查找特定信息。搜索是读者的最后一条导航路径，也是最常用的"救命"手段。很多读者不通过导航直接搜索，所以搜索优化至关重要。
让目标读者参与信息分组，发现自然的分类方式。这是最科学的信息架构设计方法，因为它直接基于读者的心智模型而非写作者的假设。开放式卡片分类让读者自由分组并命名，封闭式卡片分类让读者将卡片放入预设分类中。
# 开放式卡片分类
准备：
1. 将每个功能/概念写在一张卡片上（30-50张）
2. 邀请5-8名目标读者
3. 让他们自由分组并命名
分析：
- 聚类分析：哪些卡片总被放在一起？
- 命名分析：读者如何描述这些分组？
- 异常分析：哪些卡片归属有争议？
结果：
→ 确定顶级分类
→ 确定分类标签
→ 发现读者心智模型分析读者要完成的任务，按任务流程组织信息。任务分析特别适合操作型文档，确保文档结构与用户的工作流一致。这要求写作者深入理解用户的实际操作流程，而不是按照产品功能列表组织。
# 示例：部署任务分析
任务：部署应用到生产环境
├── 前置条件
│ ├── 服务器环境要求
│ ├── 数据库准备
│ └── 域名和SSL证书
├── 部署步骤
│ ├── 拉取镜像
│ ├── 配置环境变量
│ ├── 启动服务
│ └── 健康检查
├── 验证
│ ├── 功能验证
│ └── 性能验证
└── 回滚
├── 触发条件
└── 回滚步骤使用标准化的主题类型组织内容，确保一致性和可重用性。DITA是技术写作领域的工业标准，被IBM、Adobe等大型企业广泛使用。四种主题类型覆盖了绝大多数技术文档的需求。
| 主题类型 | 用途 | 结构要素 | 写作重点 |
|---|---|---|---|
| Concept | 解释"是什么" | 定义、背景、关系 | 帮助读者建立心智模型 |
| Task | 指导"怎么做" | 前置条件、步骤、结果 | 每步可验证，结果可预期 |
| Reference | 提供"查什么" | 参数、选项、返回值 | 准确完整，易于查找 |
| Troubleshooting | 解决"出错了" | 症状、原因、解决方案 | 症状导向，快速定位 |
# DITA主题类型应用示例
## Concept: 什么是负载均衡
负载均衡将请求分发到多个后端服务器...
## Task: 配置负载均衡
1. 安装 Nginx
2. 配置 upstream
3. 设置健康检查
## Reference: upstream 配置参数
| 参数 | 类型 | 默认值 | 说明 |
| server | string | - | 后端地址 |
| weight | int | 1 | 权重 |
| max_fails | int | 3 | 最大失败次数 |
## Troubleshooting: 负载均衡常见问题
症状：502 Bad Gateway → 检查后端服务是否运行以下是一个完整的SaaS产品文档架构设计。注意它是如何结合多种组织方式的：入门部分按学习路径，操作指南按任务，参考手册按主题。这种混合组织方式是最佳实践——没有一种组织方式能完美覆盖所有需求。
docs/
├── getting-started/ # 新手入门（按学习路径）
│ ├── quick-tour.md # 5分钟体验
│ ├── installation.md # 安装指南
│ └── first-project.md # 第一个项目
├── concepts/ # 核心概念（Concept）
│ ├── architecture.md # 系统架构
│ ├── data-model.md # 数据模型
│ └── security.md # 安全机制
├── guides/ # 操作指南（Task）
│ ├── project-setup.md # 创建项目
│ ├── team-management.md # 团队管理
│ ├── integration.md # 集成第三方
│ └── deployment.md # 部署发布
├── reference/ # 参考手册（Reference）
│ ├── api.md # API参考
│ ├── cli.md # CLI命令
│ ├── config.md # 配置选项
│ └── error-codes.md # 错误码
├── troubleshooting/ # 故障排除
│ ├── common-issues.md # 常见问题
│ └── faq.md # FAQ
└── changelog.md # 变更日志信息架构设计完成后，需要通过量化方法评估其有效性。直觉和经验很重要，但数据驱动的评估更能发现盲点。
| 指标 | 测量方法 | 目标值 | 改进方向 |
|---|---|---|---|
| 找到率 | 3次点击内找到目标信息 | >90% | 优化分类和导航 |
| 完成率 | 按文档完成任务 | >80% | 改进步骤清晰度 |
| 满意度 | 文档评分1-5星 | >4.0 | 综合内容质量提升 |
| 搜索成功率 | 搜索后找到并点击 | >70% | 优化关键词和标题 |
| 跳出率 | 进入后立即离开 | <30% | 改善首页体验 |
# 树测试（Tree Testing）
目的：验证信息分类是否合理
方法：
1. 移除所有视觉设计，只保留导航结构
2. 给参与者一个任务："找到如何配置邮件通知"
3. 观察他们选择的路径
4. 统计：成功率、路径长度、误入分支
好结果：通知配置 → 设置 → 通知 → 邮件通知 ✅（3步）
问题结果：通知配置 → ? → 系统 → ? → 消息 → ? ❌（迷路了）
→ 说明"通知"不在用户预期的位置，需要调整分类良好的信息架构不仅帮助人类读者，也帮助搜索引擎理解你的文档。URL结构、页面层级、内部链接都是SEO的重要因素。技术文档的SEO常常被忽视，但好的SEO能让你的文档被更多人发现。
# 文档URL设计原则
好：/docs/api/authentication （语义清晰）
好：/docs/guides/deployment （层级分明）
差：/docs/page?id=123 （无语义）
差：/docs/a/b/c/d （层级过深）
# URL最佳实践
- 层级不超过3层
- 使用小写英文和连字符
- 包含关键词
- 保持稳定性（避免频繁改URL）为一个"在线教育平台"设计文档信息架构，考虑学生、教师、管理员、开发者四种角色。画出目录结构，标注每个部分的主题类型。
将20个功能点分成5-7组并命名：用户注册、密码重置、权限管理、数据库备份、日志查看、API密钥、Webhook配置、邮件通知、仪表盘、报表导出、插件安装、主题定制、多语言、性能监控、告警规则、集群部署、滚动更新、灰度发布、数据迁移、审计日志。
为你当前项目的文档设计3个树测试任务，描述：任务描述、预期路径、可能的迷路路径。
✅ 验证通过：掌握信息架构的核心概念和设计方法
✅ 验证通过：能够运用DITA主题类型组织内容
✅ 验证通过：能够评估和优化文档的信息架构
掌握了信息架构的基础知识后，以下是一些进阶技巧，帮助你设计更优秀的信息架构。
没有一种组织方式能完美覆盖所有需求。最佳实践是混合使用多种组织方式：入门部分按学习路径，操作指南按任务，参考手册按主题。这种多维度组织让不同类型的读者都能找到最适合自己的路径。
创建一个可视化的文档地图，展示所有页面之间的关系。文档地图帮助读者理解全局结构，也帮助写作者发现信息缺口和重复内容。它就像地铁线路图，让读者一眼看出如何到达目的地。