Open CHN-STUDENT opened 4 years ago
RT， 在部署单机版中发现以下问题 1、克隆的源码与API文档不符，不注意修改的话部署会失败
如 https://docs.opendevops.cn/zh/guide/install/local/#api%E7%BD%91%E5%85%B3 和部署代码不一样，需要自己修改。
2、文档存在setting.py和shell脚本混写的形式，会产生理解歧义
setting.py
如 https://docs.opendevops.cn/zh/guide/install/local/#%E8%B5%84%E4%BA%A7%E7%AE%A1%E7%90%86 的通过 docker 安装 webterminal 过程，没有注明需要安装 docker，同时下面的 WEB_TERMINAL 变量应该是setting.py的配置，容易误解成shell脚本的变量。
3、文档需要在修改的地方特别标注，否则部署也会失效 特别需要修改的地方建议加红加粗，因为部署文档过长，有时候可能就容易忽略。
另外部署建议提供可下载脚本而不是自己复制粘贴脚本。
感谢。
RT， 在部署单机版中发现以下问题 1、克隆的源码与API文档不符，不注意修改的话部署会失败
如 https://docs.opendevops.cn/zh/guide/install/local/#api%E7%BD%91%E5%85%B3 和部署代码不一样，需要自己修改。
2、文档存在
setting.py和shell脚本混写的形式，会产生理解歧义如 https://docs.opendevops.cn/zh/guide/install/local/#%E8%B5%84%E4%BA%A7%E7%AE%A1%E7%90%86 的通过 docker 安装 webterminal 过程，没有注明需要安装 docker，同时下面的 WEB_TERMINAL 变量应该是
setting.py的配置，容易误解成shell脚本的变量。3、文档需要在修改的地方特别标注，否则部署也会失效 特别需要修改的地方建议加红加粗，因为部署文档过长，有时候可能就容易忽略。
另外部署建议提供可下载脚本而不是自己复制粘贴脚本。
感谢。