软件研发的协作过程中，文档是必不可少的一环，有需求文档、接口文档、使用文档等等。当开始写文档时，首先会遇到两个问题：
team members 之间如何协作？
文档 OK 后如何分发，去哪里看？如何更新?
很早的时候采用 word+ppt 做文档，然后放到共享服务器（ftp，samba）上，这种方式会有文档锁定和覆盖的问题，几个人的小团队还可以，大不了更新的时喊一嗓子：“我要更新文档了，大家都不要占用某某文件（使用windows共享文档的童鞋应该很熟悉）”。更新完了还要再喊一嗓子。除此之外，由于 word 文件格式（word文件其实是个压缩包，由很多 xml 和其他文件构成）太过于复杂，即便是借助 git 或者 svn 做版本控制，一旦产生冲突，很难通过肉眼合并和解决冲突。
那么如何解决上述问题呢？这篇文章我用 gitbook + flow.ci 进行文档的发布、集成和部署，希望给有需求的同学一些参考。
如何进行文档协作 & 版本控制 （git+markdown）
开发团队使用 git 或 svn 作为协作和版本控制工具已经是很成熟的方案了，当然也可以用于文档，只是word文档本身天然不太适合版本控制，markdown 是一种轻量级的标记语言, 学习简单，上手容易(具体语法参考 http://wowubuntu.com/markdown/) , 配合 git 几乎能做到完美的文档版本控制 。
如何发布文档 （gitbook+nginx）
最好的方式是把文档发布为 web 网站，这样无需安装任何工具即可查看文档，更新时只需更新网站即可。在这里，用 gitbook 将 markdown 文件快速生成为网站。
什么是 gitbook 呢？官网上是这么介绍的:
GitBook is a modern publishing toolchain. Making both writing and collaboration easy.
简单来说就是将 markdown 文档转换成 html、pdf、epub 等多种格式，很多开源软件和书籍都是用 gitbook 发布的，
如：
延伸阅读
- ssh框架 2016-09-30
- 阿里移动安全 [无线安全]玩转无线电——不安全的蓝牙锁 2017-07-26
- 消息队列NetMQ 原理分析4-Socket、Session、Option和Pipe 2024-03-26
- Selective Search for Object Recognition 论文笔记【图片目标分割】 2017-07-26
- 词向量-LRWE模型-更好地识别反义词同义词 2017-07-26
- 从栈不平衡问题 理解 calling convention 2017-07-26
- php imagemagick 处理 图片剪切、压缩、合并、插入文本、背景色透明 2017-07-26
- Swift实现JSON转Model - HandyJSON使用讲解 2017-07-26
- 阿里移动安全 Android端恶意锁屏勒索应用分析 2017-07-26
- 集合结合数据结构来看看(二) 2017-07-26
学习是年轻人改变自己的最好方式