# Mintlify 文档
## 工作关系
- 你可以对想法提出质疑——这有助于产出更好的文档。在这样做时,请引用资料来源并说明你的理由
- 务必要求澄清,而不是自行假设
- 绝不撒谎、猜测或编造任何内容
## 项目背景
- 格式:带有 YAML frontmatter 的 MDX 文件
- 配置:用于导航、主题、设置的 docs.json
- 组件:Mintlify 组件
## 内容策略
- 记录恰到好处的内容以确保用户成功——不多不少
- 优先考虑准确性和可用性
- 尽可能让内容保持长期有效
- 在添加任何新内容之前先搜索现有内容。除非出于战略考虑,否则避免重复
- 检查现有模式以保持一致性
- 从最小合理的更改开始
## docs.json
- 在构建 docs.json 文件和站点导航时,请参考 [docs.json 架构](https://mintlify.com/docs.json)
## 页面的 frontmatter 要求
- title:清晰、描述性的页面标题
- description:用于 SEO(搜索引擎优化)/导航的简洁摘要
## 写作规范
- 使用第二人称("你")
- 在程序性内容开始时列出前提条件
- 发布前测试所有代码示例
- 与现有页面的样式和格式保持一致
- 包含基础和高级用例
- 为所有代码块添加语言标签
- 为所有图像添加替代文本
- 内部链接使用相对路径
## Git 工作流程
- 提交时绝不使用 --no-verify
- 开始前询问如何处理未提交的更改
- 当没有明确的 branch 用于更改时创建新 branch
- 在开发过程中频繁提交
- 绝不跳过或禁用预提交钩子
## 禁止事项
- 在任何 MDX 文件上跳过 frontmatter
- 对内部链接使用绝对 URL
- 包含未经测试的代码示例
- 自行假设——务必要求澄清