对技术文档提个建议 https://docs.pingcap.com/zh/tidb/stable

首先觉得tiup这个工具很赞 一个入口简单的命令就可以让新手快速获得一个环境 快速进入技术学习阶段 类似 http://get.tech.com/install.sh | bash这种 很人性化
一个新手来了解体验一个新东西 最希望快速获得一个环境 但是现在很多技术文档和博客文章都是把一个配置文件的内容拆散了放在文章各个段落来描述 最后还不能提供个完整的样例 我想作为一个技术人员 编辑修改那些配置文件没有丝毫难度 学习者要学习的是技术特性不是如何编辑配置文件 但是目前的情况是学习者为了凑出一个正确的配置文件要花费大量的时间 有时由于文章的错误导致需要靠猜和经验才能配置正确 如果文档和博客作者能把文章提到用到的配置文件样例打包供学习者下载是不是更好?

复杂的环境配置对初学者就是最大的障碍 加上文章文档的错误或者版本更新导致的误差 初学者要化大量大量的时间才能弄好一个新环境 这也是为什么docker这种东西有市场的原因
提供个样例(包括目录结构 这个很重要)下载对我们帮助太大了