拒绝码农 - 从自身做起

下文为文档《报表需求 - 仪表盘样式》中的一部分。

2016年11月21日 下午7:26

@XXX

1. 箭头下的百分比调整的样式已套用，并已部署在测试环境。
2. 服务器设置的百分比为正数时不显示 +，负数会显示 -。
3. 百分比长度测试未覆盖，比如 12.3%, -12.3% 会样式越出框线。（服务器百分比保留一位小数）

关于前端代码思路、性能考虑、文字写作提些建议:

1. 带着思考敲码是开发者或工程师，堆积代码是码农。

   • 1.1 幽灵代码

     # mobile_v2.1.css: 27-29
     .databox .databox-vertical .databox-top, .kpi-text-align-center {
         text-align: left!important;
     }
     

     为什么会出现这样的代码，类名写的很清楚 *-text-align-center，它的作用就是让文本水平居中，如果你想水平居左应该创建新类，名称叫 *-text-align-left 才对。

     这样指东说西的堆积代码是不可能健壮稳定的，迟早会成为幽灵代码；自己写的代码必须要知道它会如何运行，并一定这样执行，使用你能想到的方式尝试做到这一点。

     作业: 前端 javascript/css/images 命名规范。

   • 1.2 怕冲突为何还要继续制造更冲突

     # mobile_v2_group_165_role_7_kpi.html: 14-15
     
     
     

     明明添加一个新类就可以解决的问题你使用了上述告诉别人居中，实际居左的幽灵写法，怕继续代码冲突新建样式脚本这种做法虽消极但也能接受，那为何还要加载可能冲突的样式脚本文件？单文件内代码可能冲突，把两个样式脚本文件放在一起岂不是更冲突？

     作业: 前端性能最佳实践方式。

     • 1.3 没有测试意识

       箭头下的百分比数据是抽取代码中没有的，需要手工添加，为何那么多仪表盘框都只写 +0.1%? 实际场景肯定不会这么单一，为何不把可能的几种状况都写一下:

       • +0.1%
       • +10.1% (走到这里，样式就开始失常)
       • +10.1%
       • +100.1%
       • ...(测试出样式支持的最大字符长度）

       若是有测试意识的添加数据，上述问题会一步到位或减少交流次数，协作效率肯定是现在状态的数倍。

       作业: 前端如何更高效率的与后台开发同事协作。

2. 做对仅仅是及格，如何做得更好，再更好

   当前已卡在第一条，强调这条似乎有些多余，但这条才是我们团队要求的最基本条件。

   多加载一个样式脚本文件会增加浏览器解析压力，增大客户端样式文件体积，是在浪费各种资源。我们的目标在做减法，做减法与做加法的难度是不在同一个级别上的，是具有挑战性的，虽然我们更多的是在做加法，但要有做减法的意识。

   搬砖是垒不出高楼大厦的，更何况我们想建造的是摩天大楼。albert 与每位团队成员都有过单独交流并有这样的契约：设定自己的目标同时团队协助他成长，这就是为什么简单的一件工作协作小问题引出这么一大段反馈的原因。

3. 文字写作

   有一个时间段说不上时间长也不算短大概一个月多点，让大家熟悉使用 markdown 语法写作任何工作交流文档，甚至后来进来的同事在考核测试任务中都包括使用 markdown 写作。

   大家每天都在使用 markdown 写工作日志，应该熟能生巧才对，可现在的工作文档内容不得不说日渐凌乱，一直在用的东西都没有充分吸收，不知道该如何描述这种感觉，想的东西做出来或在努力的尝试做出来才能得到别人的尊重，否则堂而皇之说自己想变得更强更棒永远都是笑话。

   该段落小标题是文字写作，键盘敲出来的都是文字，码农搬码算不得写作，日常交流中词不达意、错字连篇的文档都算不上写作，其实写作就是一种态度，用心想、用心写、用心交流，公司项目文件夹中称得上写作的文档太少。

   延伸一下用心交流，希望各位在点击发送、共享前再认真阅读一遍，大家协作的是工作，而非因你的乱语、错字反问具体想表达什么意思，做好这一点我想相信对大家的生活习惯也会有益处。

   项目中的每一行代码、每一段文字、每一张图片都需要大家用心琢磨如何才能做得更好，大前提是要了解项目中有那些代码、文字、图片，这个需要大家自觉去理。工作职位是明确的，那你知道项目中那些模块是需要你负责的吗？

第一条是针对代码问题反馈给XXX的建议，其他两条是写给每一位同事的，每个成员都是管理者，都具有发言权。

我希望团队更好更棒更强，今天我发言。