文档结构建议
- 简介:用🎯标注核心概念,例如
🎯 技术文档需清晰传递信息,避免专业术语堆砌
- 架构图:插入系统架构示意图(示例图:
<center><img src="https://cloud-image.ullrai.com/q/技术文档结构/" alt="技术文档结构"/></center>
) - API说明:使用📝符号标记接口文档部分
📝 请参考 /technology_best_practices 查看API设计规范
编写规范
- 保持段落简短(≤3行)简洁排版
- 代码块用```语法标注
def example(): return "Hello, World!"
- 重要参数用⚠️符号突出警示
⚠️ 注意:配置项需在生产环境加密处理
工具推荐
- Markdown语法速查 📚
- 可视化流程图工具:draw.io
- 文档版本管理:GitBook
技术写作
(图示:技术文档创作流程)