贡献文档

良好的使用文档对任何类型的软件都是至关重要的。欢迎任何可以改进 DolphinScheduler 文档的贡献。

获取文档项目

DolphinScheduler 项目的文档维护在独立的 git 仓库中。

首先你需要先将文档项目 fork 到自己的 github 仓库中，然后将 fork 的文档克隆到本地计算机中。

  1. git clone https://github.com/<your-github-user-name>/incubator-dolphinscheduler-website

文档环境

DolphinScheduler 网站由 docsite 提供支持。

如果你的 docsite 版本低于 “1.3.3”，请升级到 “1.3.3”。

请确保你的 node 版本是 8.x，docsite 尚不支持高于 8.x 的版本。

文档构建指南

  1. 运行 “npm install docsite-g” 安装开发工具。

  2. 在根目录中运行 “npm i” 以安装依赖项。

  3. 在根目录下运行 “docsite start” 启动本地服务器，其将允许在 http://127.0.0.1:8080。

  4. 运行 “docsite build” 可以生成文档网站源代码。

  5. 在本地验证你的更改：python -m SimpleHTTPServer 8000，当 python 版本为 3 时，请使用：python3 -m http.server 8000。

如果本地安装了更高版本的 node，可以考虑使用 “nvm” 来允许不同版本的 node 在你的计算机上运行。

  1. 参考说明安装 nvm

  2. 运行 “nvm install v8.16.0” 安装 node v8

  3. 运行 “nvm use v8.16.0” 将当前工作环境切换到 node v8

  4. 运行npm install docsite-g

然后你就可以在本地环境运行和建立网站了。

文档规范

  1. 汉字与英文、数字之间需空格，中文标点符号与英文、数字之间不需空格，以增强中英文混排的美观性和可读性。

  2. 建议在一般情况下使用 “你” 即可。当然必要的时候可以使用 “您” 来称呼，比如有 warning 提示的时候。

怎样提交文档 Pull Request

  1. 不要使用 “git add.” 提交所有更改。

  2. 只需推送更改的文件，例如：

  • *.md
  • blog.js or docs.js or site.js
  1. 向 master 分支提交 Pull Request。

参考文档

Apache Flink 中文文档规范