《开源框架那点事儿18》:为什么要先从测试用例编写和文档编写开始?

有一个同学,问我一个问题:加入Tiny是否必须从写单元测试用例和文档作起?

此问题引发我诸多感触,故形成乱弹一篇。

作为一个新加入者,多看、少说,是正点。而这个时候,写写测试用例、文档,就是个不错的选择。这样入手比较容易,也比较容易体现水平。

可以说好的程序员,测试和文档都是写得好的。测试和文档一定写不好的,一定不是好的程序员。

同时,在看代码,写测试用例、写文档的过程中,还可以这样思考:

他为什么要这么设计?换成我,我会怎么设计?然后有相当一部分,会转化成:哦,原来是这个样子的!这个时候你进步了。然后有一部分留下来,让原作者转化成:哦,原来是这个样子的!然后他进步了,开源作品进步了。还有一部分,他会告诉你,故事是这样发生的,因此要如此这般,再转化成你的:哦,原来是这个样子的!!!于是你更进一步了。

其实写文档也是同样的道理,正所谓:测试用例就是程序,文档就是程序。

在你熟悉了相当一部分之后,你的发言权越来越大,你得到大家的认可越来越多,你的工作范围当然也会越来越宽广、丰富。

之所以说,多看、少说,是因为,这里的一切都你都还很陌生,许多故事,你还没有了解清楚,这个时候,多看,可以多发现他的优点、或者存疑的缺点,再慢慢印证,剔除自己理解错误的,留下真正存在的,这个时候,你就非常容易融入团队。

最忌讳的一种情况就是,只看了几眼代码,就这也不对、那也不好,可能你说的有几条是确实有的,但是更多的是你有些东西没有理解清楚,毕竟,要挑战别人已经仔细推敲、思考过的解决方案,需要有更深的分析、积累、沉淀。,如果你提得非常好、非常对,团队会非常感谢你,毕竟能做开源的,胸襟肯定是有的;如果总是拿自己的不仔细阅读、思考来浪费别人的时间,最后就难于融入团队。

当年,许多好汉加入水泊梁山,都要去做一点事情,表示你是真心愿意加入的,比如:下山去干一票,取个人头回来等等。在加入Tiny框架时,在你的真正水平显现之前,先做做测试用例和写写文档,也是这么个意思。如果写得测试用例质量好,还发现了原来存在的若干重大缺陷,怎么可能会不被重用?如果连测试用例也写不好,文档也写不好。也就意味着让你写代码,你也写不好测试用例,写不好文档,这对于开源组织来说是无法承受的。

所以,不要看不起写测试用例和文档相关的工作。



欢迎访问开源技术社区:http://bbs.tinygroup.org。本例涉及的代码和框架资料,将会在社区分享。《自己动手写框架》成员群:228977971,让我们一起动手,了解开源框架的奥秘!

开源访谈录

时间: 2024-08-14 10:58:57

《开源框架那点事儿18》:为什么要先从测试用例编写和文档编写开始?的相关文章

《开源框架那点事儿18》:为什么从开始的第一个测试写入和文档?

有一个同学.问我一个问题:增加Tiny是否必须从写单元測试用例和文档作起? 此问题引发我诸多感触,故形成乱弹一篇. 作为一个新增加者.多看.少说,是正点. 而这个时候.写写測试用例.文档,就是个不错的选择. 这样入手比較easy,也比較easy体现水平. 能够说好的程序猿.測试和文档都是写得好的. 測试和文档一定写不好的,一定不是好的程序猿. 同一时候,在看代码.写測试用例.写文档的过程中.还能够这样思考: 他为什么要这么设计?换成我,我会怎么设计?然后有相当一部分.会转化成:哦,原来是这个样子

《开源框架那点事儿11》:软件开发杂谈

杂谈之中的一个:技术仅仅是成功的一点点基础条件.真正还是得靠做人 话说,有位lianzi同学.水平不错.思想超前,签约阿里如今在百度实习,曾经由于喷我的贴又没有啥理由,因此告诉他离我远一点.可是近期他又回到我群里了.一直伸个大拇指,我说啥他都是大拇指,认为怪怪的.总不是那么个感觉,最终憋了一段时间,又恢复了正常的沟通方式,聊天实录: [传说]杭州-悠然 18:31:13 lianzi本色最终出来了. [传说]杭州-悠然 18:31:30 我学得这样才是你自己.你天天伸个大拇指.我都认为不像你了.

《开源框架那点事儿25》:对框架模板引擎实现方式的改造实录

点滴悟透设计思想,Tiny模板引擎优化实录! 增加框架设计兴趣小组:http://bbs.tinygroup.org/group-113-1.html Tiny模板引擎的实现方式原来是採用的编译方式,近期发生了一些问题.因此我认为有必要把编译方式调整为解释方式,为此就開始了此次实现活动. 编译方式存在的问题 当时採用编译方式.主要是考虑到编译方式在执行时不必再去遍历语法树.因此就採用了编译方式. 可是在实际应用其中,出现了例如以下问题: 文件路径冲突的问题 因为採用的是编译方式,这个时候就存在在

《开源框架那点事儿23》:采用TinyDB组件方式开发

采用TinyDB组件方式开发 步骤 Icon 前文介绍四则运算的流程编程开发时,说过流程编排在开发重复功能时,可以利用已有的组件库快速开发.对于开发人员而言只需要简单配置流程就可以完成工作了. 开发增删改查的组件接口.本来这部分很花费时间,如果采用组件复用的话,就可以实现一次开发,终生受益. 配置curd.beans.xml和tinydb.xml. 使用流程编辑器定制组件流程curd.pageflow. 修改页面文件:list.page和operate.page,使之符合流程方式调用. 修改布局

《开源框架那点事儿17》:与屈原对话及开源精神

竹子与开源:扎根是为了长得更高 端午节到了,人们都在讨论屈原不屈不挠的精神,以及龙舟.粽叶等世界文化遗产.粽叶清淡,给人无限的遐想.或者,你很容易想起和粽叶形状比较类似的竹叶,以及屹立挺拔的骨感竹子.竹在清风中瑟瑟的声音,在夜月下疏朗的影子,都让文人墨客深深感动.而竹于风霜凌厉中苍翠依然的品格,更让诗人引为同道.苏东坡曾在<于潜僧绿筠轩>里宣称,"宁可食无肉,不可居无竹.无肉令人瘦,无竹令人俗.人瘦尚可肥,士俗不可医."当年郑板桥曾作<竹石>,细细品味,也给人许

《开源框架那点事儿20》:自己动手写前端框架

曾经发表过一篇文章:TinyAdmin前端展现框架.其在线演示路径为:http://www.tinygroup.org/tinyadmin/.应该说有很多人还是感觉兴趣的,可是因为这个是基于SmartAdmin框架改写的,尽管我们自己买了SmartAdmin的授权,可是广大用户假设要用的时候,就会有授权相关的问题,这会大大影响一些人的使用决策--尤其是会再发行的朋友. 再一个原因是SmartAdmin初看不是不错的.可是实际用起来.里面的问题比較多.对IE8基本上能够说是不兼容,尽管我们努力进行

开源框架那点事儿25》:对框架模板引擎实现方式的改造实录

点滴悟透设计思想,Tiny模板引擎优化实录! Tiny模板引擎的实现方式原来是采用的编译方式,最近发生了一些问题,因此我觉得有必要把编译方式调整为解释方式,为此就开始了此次实现活动. 编译方式存在的问题 当时采用编译方式,主要是考虑到编译方式在运行时不必再去遍历语法树,因此就采用了编译方式.但是在实际应用当中,出现了如下问题: 文件路径冲突的问题 由于采用的是编译方式,这个时候就存在在一个选择,即:Java源代码落地或不落地的选择.如果Java文件不落地,则在有问题的时候,如果想要进行代码调试(

《开源框架那点事儿20》:发布TinyUI前端框架

以前发表过一篇文章:TinyAdmin前端展现框架,其在线演示路径为:http://www.tinygroup.org/tinyadmin/,应该说有许多人还是感觉兴趣的,但是由于这个是基于SmartAdmin框架改写的,虽然我们自己买了SmartAdmin的授权,但是广大用户如果要用的时候,就会有授权相关的问题,这会大大影响一些人的使用决策--尤其是会再发行的朋友. 再一个原因是SmartAdmin初看不是不错的,但是实际用起来,里面的问题比较多,对IE8基本上可以说是不兼容,虽然我们努力进行

《开源框架那点事儿19》:特斯拉建“桩”与开源的生命力

在美国的硅谷,在中国的中关村,许多的技术先驱者怀揣梦想,用激情不懈地追求着他们宏远的目标和巨大的个人财富.开源,正在成为这个时代目前最火热的名词之一.开源精神,作为一种合作协同的驱动力,正在发展为一种更具竞争力的产品开发模式. 我们可以从几个典型故事说起. 一.特斯拉建“桩” 2014年5月份,苹果与三星的专利侵权案做出判决,三星向苹果赔偿约1.2亿美元,巨头公司们再次向世人展示“专利”两字的份量可以重若泰山.然而,时隔一个月后,特斯拉电动车宣布开放其所有专利,仿佛要告诉人们,其实“专利”两字可