作者:Vita Lu
TiDB 社区用户体验探索者和学习者。
写在最前面
作为 TiDB 社区的工作人员,我在工作中常常和技术人员打交道,在这些人当中,有些人天生带着热心肠,对技术布道兴致盎然;有的人是技术宅,对新技术新产品充满好奇;还有些比较典型的程序员朋友,在不声不响间已经默默刷完了某教程某技术专栏。这些乐于阅读,善于交流的朋友们绝对是一群绝佳的技术专栏潜在使用者。
当然也有部分内敛的技术伙伴们看到【写作】这两个字,不禁觉得头痛,总觉得是一件很艰难的事。然而,实际上,不仅仅是阅读他人文章,写作对于技术同学来说也是一项【重要】且【易于学习】的技能,该技能或许可以改变技术同学们的职业生涯。
这篇文章将和大家分享 TiDB 社区专栏的产品故事,讨论为什么技术人员应该成为更好的读者和作家以及该怎么做。
TiDB 社区专栏是什么
TiDB 社区专栏是社区技术文章的集合地,是 TiDB 用户/爱好者【交流思想】和【分析问题】的博客平台。
作为专栏系统的设计者之一,这是我对于它的基本定义(欢迎指正)。虽然在最早期的产品设计过程中,我只是将它视为一个 “能够承接社区问答论坛 asktug 中技术文章版块内容的工具”。事实上,它作为一个平台型的社区产品,的确是个【工具】,只不过在发挥它作为内容平台的基础作用的同时,我们也希望大家能把它用“好”,继续挖掘出它更深层次的意义。
我们期待在这里看到你耀眼的思维火花,也希望你能在这里解决实际工作中遇到的技术问题。
为什么要撰写技术文章
技术文章是分享你的专业知识,同时建立潜在有价值的读者群的好方法。它可以帮助你记录项目,或为其他 TiDB 用户提供指导。
正如开头所说,在现实生活中许多技术人员都是内向的人,他们通常会和他们觉得舒服的少数人一起出去玩(猜的👀)。当他们在网上撰写技术文章并与他人分享该作品时,能够和其它志同道合的朋友互动。如果你写了一篇技术文章记录了一次 TiDB 试用过程中的踩坑经历,并插入了一段当时你遇到问题的代码,你认为会发生什么呢?最有可能的是,你会被那些对如何改进代码、你做错了什么、你应该做什么等等有想法的人的评论所淹没。或许在评论区会引发一些思想的碰撞,但你说不定能从别人那里学到一些新知识。并且每个人在使用产品/技术的时候遇到的问题都是特别的、特殊的,像这样的【定制化】技术内容往往很难在其它平台得到类似的正确答案。如果那些在工作中遇到类似问题的同行看到了你的分享,并且运用你的文章解决了棘手的业务问题,他们一定会感谢你的热心。
或许你没有意识到,当你与他人分享自己的想法时,他们可以向你学习。这是互通的:你分享你所知道的,人们会用他们所知道的来评论。这恐怕就是社区活跃、互助的意义所在吧。
你可能会发现自己的新爱好、新兴趣 —— 喜欢在网上与人互动💬。你也可能会发现志同道合的人成为你的新朋友👬。又或许,你可能会找到原本你不知道的新工作机会💼。
以下内容引自 https://zhuanlan.zhihu.com/p/348995084,总结得很全面👍
所以写博客有很多的好处:
- 写博客的过程中就是思考的过程,能加深你对知识的理解以及运用,更重要的是你会忘,但是通过自己写的博客能很快的回忆起来
- 写博客的过程中,有成就感,学会了一个知识点,写出来别人也能看,有种成就感而且更能激发自己的学习热情
- 当博客积累的有一定量的时候,能在技术社区里面有更多的人看到,能认识更多的同行,技术朋友,甚至还有人帮你推荐工作
- 自己的技术博客也是对面试官一个很好的个人展示,笔者就有朋友,学历一般,但是通过写博客,被大厂技术主管发现并录用,且工资不低
- 锻炼自己的写作能力,写作也是一种很重要的能力
- 好多我们所谓的技术大牛,有很多都是通过写博客曝光自己的,才小有名气的
- 博客写的好,有可能会有出版社找到人,出书,还能赚点稿费,最关键的是在业内也是个小名人了找工作谈工资什么的,多了几分把握了
- 最后一条是最重要的,就是自己的技术上的提升,自己的能力的提高
如何创作 TiDB 社区专栏的文章
此处套用一句经典的广告语 “Just Do It”
看到这里,你是否担心自己不够专业,无法就某个主题进行写作?其实不用担心,每一个写作者在创作之前几乎都会去研究你需要知道的东西。(正如我现在开着无数个浏览器窗口,搜索记录都是类似“如何写好第一篇专栏文章”的内容)
也许你担心自己说错话。每个作家都会犯错,而读者往往喜欢在这件事上帮你指出来。这是一件好事!你也可以重新编辑/修正文章内容,并重新发布你的作品。如果你和读者持有不同的观点,分不清谁对谁错,那就请更多人来阅读并裁判吧,不要忘记,你的背后有整个社区的力量。
不要担心写得太简单,或者看起来像新手,或者太复杂以至于超出读者的理解范围,在社区里,你总会找到能够理解你文章的读者。
此外,这几个链接或许对你提高写作技巧有帮助:
产研技术文章写作培训系列之:「浓缩咖啡 vs. 香草拿铁:让更多的读者Get你 - 如何提高技术文章的易懂性」
https://blogging.com/technical-blogging/
https://www.freecodecamp.org/news/how-to-write-a-great-technical-blog-post-414c414b67f6/
其它关于如何创作 TiDB 社区专栏的文章,欢迎你在专栏首页左下角查看【专栏发布指南】 🧭。
写在最后
对于我们整个 TiDB 社区产品运营团队来说,打造【社区专栏】,是一次重要尝试和挑战。我们将原属于问答论坛内的技术文章内容搬运到新的专栏平台,是希望社区各个平台(问答论坛、专栏、活动等)的内容更加纯净,都能“各司其职”,让你能够有更佳的使用体验,方便你快速定位、获取有价值的内容。
当然,现在你所体验的社区专栏 1.0 版本还处在蹒跚学步的婴幼儿状态,在打造更优秀的社区产品路上,我们期待与你同行,一起提升社区用户体验,共建社区。任何反馈和想法💡欢迎直接在评论中指出和提出!😊😊😊
最后,感谢 @sykp241095 @Seren @Billmay @luzizhuo @cw1997 @zhiyuan 在产品设计以及开发过程中的支持❤️!