文档结构建议

  • 简介:用🎯标注核心概念,例如
    🎯 技术文档需清晰传递信息,避免专业术语堆砌
  • 架构图:插入系统架构示意图(示例图:<center><img src="https://cloud-image.ullrai.com/q/技术文档结构/" alt="技术文档结构"/></center>
  • API说明:使用📝符号标记接口文档部分
    📝 请参考 /technology_best_practices 查看API设计规范

编写规范

  1. 保持段落简短(≤3行)
    简洁排版
  2. 代码块用```语法标注
    def example():
        return "Hello, World!"
    
  3. 重要参数用⚠️符号突出警示
    ⚠️ 注意:配置项需在生产环境加密处理

工具推荐

技术写作

(图示:技术文档创作流程)