背景

最近在学习一些新技术,官方文档针对功能手册写的非常详细,这已经是非常好的文档了。

然后,实际部署使用中,还是遇到了很多问题。

经验这个东西,有很多还真是只可意会不可言传,有的则是口口相传。

自己平时在 github 写了一些开源项目,虽然自以为文档写的还算详细,但是总归还是会有很多使用问题。

已有渠道的问题

1)微信公众号发消息的问题

移动端的微信消息应该存在 BUG。

经常收到消息,结果显示是 5 天前。在回复时,提示仅支持 48 小时以内的消息回复。且一段时间消息就会被清空,无法记录。

看着对方打了一堆问题,就很无奈。

2)github issues

这个以前是我个人比较推荐的问题。

一者是内容不会丢失,再者是其他开发者也可以看到。

不过缺点也比较明显,实时性不足。最近经常发现别人提的问题,完全没收到邮件通知,看的时候,已经过去几个月了。

个人问题

一个是我这个人懒散随意惯了,时间精力也有限。

秉承着为开源事业应当山川相映,生生不息的理念,一个人的力量毕竟太有限,所以还是考虑为生态社区做一点点考虑。

这样用户遇到问题,实践和经验也可以保留下来。

生态社区

除了各个平台的博客。

也可以在下面的几种渠道:

1)github

遇到问题可以在 github 提问题,如果没回复(邮件丢失),可以添加个人公众号。

https://github.com/houbb

2)个人公众号

公众号:老马啸西风

PS:提问题尽量别发消息,建议留言。不然消息会丢。

个人公众号

3)交流群

以前太懒不想创建。这里新建一下,便于日常问题交流,估计平时也不太维护。

可以个人公众号留言之类的,或者每周发一次群图片推文?

发现群二维码有效期只有几天(有点麻烦)

4)日常 QA/经验/技术文章等

定时手机常见的 QA,以周报或者月报的方式发一下文章。

QA 之类的最好时能有一个共享文档,到时候群里可以贴一个腾讯文档之类的。

原创经验/技术文章可以直接投稿,审核通过后直接发。

5)生态共建

如果有小伙伴对开源比较感兴趣,也可以针对已经的项目提申请,成为 commiter。

也不单单局限于技术开发者。

有以下任何一个偏好都可以

a. 各种文档的维护者。比如技术文档编写、最佳实践、日常 QA 等等

b. 测试用例维护。测试同学的可以考虑。

c. 运维经验。运维同学可以参与

d. 多媒体运营。开源宣发等等

e. 气氛大师,能说会道

愿景

水流不争先,争生生不息。