背景
最近在学习一些新技术,官方文档针对功能手册写的非常详细,这已经是非常好的文档了。
然后,实际部署使用中,还是遇到了很多问题。
经验这个东西,有很多还真是只可意会不可言传,有的则是口口相传。
自己平时在 github 写了一些开源项目,虽然自以为文档写的还算详细,但是总归还是会有很多使用问题。
已有渠道的问题
1)微信公众号发消息的问题
移动端的微信消息应该存在 BUG。
经常收到消息,结果显示是 5 天前。在回复时,提示仅支持 48 小时以内的消息回复。且一段时间消息就会被清空,无法记录。
看着对方打了一堆问题,就很无奈。
2)github issues
这个以前是我个人比较推荐的问题。
一者是内容不会丢失,再者是其他开发者也可以看到。
不过缺点也比较明显,实时性不足。最近经常发现别人提的问题,完全没收到邮件通知,看的时候,已经过去几个月了。
个人问题
一个是我这个人懒散随意惯了,时间精力也有限。
秉承着为开源事业应当山川相映,生生不息的理念,一个人的力量毕竟太有限,所以还是考虑为生态社区做一点点考虑。
这样用户遇到问题,实践和经验也可以保留下来。
生态社区
除了各个平台的博客。
也可以在下面的几种渠道:
1)github
遇到问题可以在 github 提问题,如果没回复(邮件丢失),可以添加个人公众号。
2)个人公众号
公众号:老马啸西风
PS:提问题尽量别发消息,建议留言。不然消息会丢。
3)交流群
以前太懒不想创建。这里新建一下,便于日常问题交流,估计平时也不太维护。
可以个人公众号留言之类的,或者每周发一次群图片推文?
发现群二维码有效期只有几天(有点麻烦)
4)日常 QA/经验/技术文章等
定时手机常见的 QA,以周报或者月报的方式发一下文章。
QA 之类的最好时能有一个共享文档,到时候群里可以贴一个腾讯文档之类的。
原创经验/技术文章可以直接投稿,审核通过后直接发。
5)生态共建
如果有小伙伴对开源比较感兴趣,也可以针对已经的项目提申请,成为 commiter。
也不单单局限于技术开发者。
有以下任何一个偏好都可以
a. 各种文档的维护者。比如技术文档编写、最佳实践、日常 QA 等等
b. 测试用例维护。测试同学的可以考虑。
c. 运维经验。运维同学可以参与
d. 多媒体运营。开源宣发等等
e. 气氛大师,能说会道
…
愿景
水流不争先,争生生不息。