开源共创一起写

这两本书的写作计划其实在很多年前就开始了。

之前组织过几次，也有一些人参与进来，但都没什么进展。现在，我们换了新版的网站，有了新的系统支持和进展，这项工作终于可以正式开始了。

写作计划

目前我们在写作的有两本书：

• 《FreeSWITCH 案例大全》
• 《FreeSWITCH 参考手册》

《FreeSWITCH 案例大全》，很简单，大家在使用 FreeSWITCH 的过程中肯定积累了很多经验，把这些经验收集起来，就是一笔很大的财富。你可以把这些财富自己珍藏着，也可以分享给大家，就如同当初你学习 FreeSWITCH 的时候大家无偿地分享给了你一样。

《FreeSWITCH 参考手册》，目标也很明确。大家经常会问到我，有没有关于 FreeSWITCH 里所有事件的列表？有没有事件里所有字段的说明？有没有挂机原因的中文解释？有没有通道变量的解释？有没有数据库的说明？这些，虽然官方有 Wiki 上有一些，但毕竟是英文的，而且也不全。

线上版的书里已经有些内容了，大家可以先看看，应该知道我大致想写成什么样子。

最近，FreeSWITCH 官方也改版了 Wiki，新的链接变成了https://developer.signalwire.com/freeswitch/。官方的文档也是社区创作的成果。之前，我们希望能做一个中文的 Wiki，但做一个中文的 Wiki 太难了，这次，我想写本书。如果不过瘾，就写两本。

写一本书是不是很难？是的，但也不全是。想一想：

• 如果每天写一个 API 的话，能不能完成？一年下来，就是 300 多个。
• 如果每天写一个 App 的话，能不能完成？一年下来，又是 300 多。
• 如果每天写一个通道变量，一年下来也是 300 多。
• 随手记录一下你收到的 FreeSWITCH 中的事件，以后在工作中可以翻出来参考，记录花的时间以后再打的时候都省出来了。
• 你还可以找到很多让自己变得优秀的理由。

如果你对本书感兴趣，你可以加入我们：

• 请确认你有时间参与进来并准备好做贡献。好多人满情激情地参与进来，一篇都没写，甚至连错别字都都改过一个，又走了。
• 想想你最后一次坚持做一件事情是什么时候？
• 你会得到本书的源代码。
• 跟运动健身一样，你会找到一些志同道合的朋友，互相鼓励、互相监督。
• 你会与我们一起工作，一起创作，一起 Review，一起合代码。
• 你会自己学会如何将本书编译成 PDF。
• 你可以加入我们的作者和读者群。
• 好处可能还有很多。
• 加入我们也不需要技术有多牛，如果你会 Git、会 Markdown，可以帮我们一起找错别字，督促大家按时完成任务，我们也欢迎后勤部长和啦啦队长。
• 加入我们很简单，到我们的Git 站点上创建个账号，你就加入我们了。
• 你可以到这里联系我们，也可以给我们发邮件 info@x-y-t.cn，注意发邮件时说明白你要做什么并留下你的联系方式。如果你跟我们不是特别熟悉，请发 300 字以内的自我介绍，让我们了解一下你。
• 另外，最重要的是：你需要提交一份写作计划。格式不限。

本书仅对贡献者开源。本书的内容是可以在线免费阅读的。

期待你的加入。

FAQ

我可以加入吗？

欢迎。我们没有门槛，只要你是认真的。

怎么才算认真？

如果加入我们一个月内，连个错别字都没改过，那几乎可以认为是不认真。如果你提交了一些内容，然后半年或一年没有动作，那就是不爱我们了。

如果你还不理解什么是我们期望的认真，那就从头再看一遍本文章。

为什么不在 Github 上共享了？

我们喜欢 Github，但是，我们放了几年之后，没有收到一个 PR，只收到一个 Issue，和寥寥几个 Star。很多国内的同学反而上 Github 有困难，我们需要把仓库放到我们自己的 Git 站点上。如果同时维护两个地方会非常复杂，因此，我们暂时关闭了 Github 上的仓库。

为什么源代码仓库不直接开放给所有人？

我们的源代码是使用 Markdown 组织的，我们使用 Pandoc 生成了 HTML，这样更易读一些。大部分人不需要读源代码，如果需要的话，可以加入我们，一起创作。

为什么不在 Gitbook 上发布？

我们希望把代码放到自己的仓库里，我们要用自己的方法生成 PDF。

这些书将来会出版吗？

也许会，也许不会，要看书的质量和反响。但我想大概率不会，因为可能一直在更新完，更适合电子版免费渐进发行的方式。但如果有人赞助，也说不定。