使用 Devin Desktop 编写文档

# Mintlify 技术写作规范

## 项目背景

- 这是一个基于 Mintlify 平台的文档项目
- 我们使用带有 YAML frontmatter 的 MDX 文件  
- 导航在 `docs.json` 中配置
- 我们遵循技术写作最佳实践

## 写作标准

- 使用第二人称（"你"）来编写说明
- 使用主动语态和现在时
- 操作步骤开始前先列出前提条件
- 为主要步骤提供预期结果
- 使用描述性、关键词丰富的标题
- 保持句子简洁但信息丰富

## 必需的页面结构

每个页面都必须以 frontmatter 开始：

```yaml
---
title: "清晰、具体的标题"
description: "用于 SEO 和导航的简洁说明"
---
```

## Mintlify 组件

### docs.json

- 在构建 docs.json 文件和网站导航时，请参考 [docs.json 架构](https://mintlify.com/docs.json)

### 标注

- `<Note>` 用于有用的补充信息
- `<Warning>` 用于重要警告和破坏性更改
- `<Tip>` 用于最佳实践和专家建议  
- `<Info>` 用于中性的上下文信息
- `<Check>` 用于成功确认

### 代码示例

- 在适当的时候，包含完整的、可运行的示例
- 使用 `<CodeGroup>` 展示多语言示例
- 在所有代码块上指定语言标签
- 包含真实数据，而不是占位符
- 对于 API 文档使用 `<RequestExample>` 和 `<ResponseExample>`

### 操作步骤

- 使用 `<Steps>` 组件编写顺序说明
- 在相关时包含带有 `<Check>` 组件的验证步骤
- 将复杂操作分解为较小的步骤

### 内容组织

- 使用 `<Tabs>` 展示平台特定内容
- 使用 `<Accordion>` 实现渐进式展示
- 使用 `<Card>` 和 `<CardGroup>` 突出显示内容
- 将图像包装在带有描述性替代文本的 `<Frame>` 组件中

## API 文档要求

- 使用 `<ParamField>` 记录所有参数 
- 使用 `<ResponseField>` 显示响应结构
- 包含成功和错误示例
- 对嵌套对象属性使用 `<Expandable>`
- 始终包含认证示例

## 质量标准

- 发布前测试所有代码示例
- 对内部链接使用相对路径
- 为所有图像包含替代文本
- 确保正确的标题层次结构（从 h2 开始）
- 检查现有模式的一致性

{
  "mcpServers": {
    "mintlify": {
      "serverUrl": "https://mintlify.com/docs/mcp"
    }
  }
}