Code Monkey home page Code Monkey logo

docs.zh-cn's Introduction

如何贡献文档

非常感谢您参与 StarRocks 文档建设,您的帮助是文档改进的关键! 贡献文档前,请您仔细阅读本文,帮助您快速了解文档的注意事项、编写流程和文档模版。

注意事项

  1. 语言:请至少选择中英文一种语言,欢迎提供中英双语版本。
  2. 索引:如果文档为新增,则需要在索引文件(TOC.md)中根据分类为新增文档添加索引,且索引路径为绝对路径。此索引文件最终将被渲染为页面的侧边目录栏。
  3. 图片:图片需要先放入文件 assets 中,文档中引用图片时请输入图片的相对路径,比如 ![test image](../../assets/test.png)
  4. 引用:如果引用官网文档,则推荐使用文档相对路径,比如 [test md](../../sql-referencest.md)
    如果引用外部文档,则引用格式为 [引用文档名称](引用文档链接)
  5. 代码块:代码块必须标明语言类型,比如:```sql。
  6. 文档中目前暂不支持出现特殊符号。

编写流程

  1. 编写阶段:按照如下文档模板,编写文档(markdown格式),并在索引(TOC.md)中添加索引。

    • 由于文档为markdown格式,建议您提前使用markdown-lint验证格式的规范性。
    • 添加索引时,请注意函数分类。
  2. 提交阶段:在github上提交文档,中文文档提交至中文文档仓库,英文文档提交至英文文档仓库

  3. 评审阶段

    评审阶段分为自动检查和人工评审。

    1. 自动检查:提交人是否已经签署CLA,提交文档是否符合markdown语法。
    2. 人工评审:Commiter会阅读并沟通文档内容。最终合入至StarRocks文档仓库,并更新官网。

文档模板

函数文档模板

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.