扫码阅读
手机扫码阅读
写在技术专栏的发布之后
63 2024-03-02
为什么写专栏,还是想做一些具有可复制性的东西,一次固定投入,边际成本很低。其实不只是专栏,任何具这种特性的事物,都值得我们去尝试。
为什么写这个选题?早先就写过一个微服务的入门示例,名为Simplemall,一个简单的购物交易,发布在Github上,现在也有660+star ,时不时还会有小伙伴问一些相关的问题。不足之处在于没有文档说明,只能靠大家去读代码。另外组件版本也比较老,没时间去更新。
输出的内容要从读者的角度出发,不能从写作人的视角写,这样不利于读者阅读学习。 要能把对读者有利的东西摆出来,而不是自我为什么要写这个东西,可能读者也不关心你为什么写 内容要有衔接性,章节之间有个过度衔接,方便读者可以快速切入上下文环境,不至于读起来很突兀。 文中引用的东西,不管是图片还是文字,尽量有来源,这也是对来源作者的尊重,如果有可能,尽量自己原创最好。 多使用图表,少写字。图表更容易被识别阅读,而文字往往会很枯燥,一图胜千言,目的是为了将东西交代清楚,方便读者快速学习掌握。 内容输出质量要有保证,基本的行文规范还是要有的,比如中英文混编时,中间要有空格。行文的数量要有保证,太短无法承载一个专栏的体量。 目录与开篇,基本上就决定了读者会不会买账,所以这两部分是关键所在,需要多打磨。
原文链接:
http://mp.weixin.qq.com/s?__biz=MzIwMjE3MDIwMA==&mid=2247486173&idx=1&sn=19baf2e078bd929688323351e36cb0de&chksm=96e380eaa19409fc88b022453ad5ebc5f51eb286808e26b9d1b3912e4a2b3c7e610ab5f6c4cc#rd
MavenTalk的其他文章
加入社区微信群
与行业大咖零距离交流学习
软件研发质量管理体系建设
白皮书上线