程序员的文档调优(一):基本守则

撰写代码是程序员的本职工作,但编写文档时至今日依然常常遭到忽视。纵有高人曰过,优雅的代码是最好的文档,但先不说多少人的代码能达到这般境界,许多事务并不能仅靠代码本身完成。例如:用户文档,不能倚赖用户去阅读代码后再使用你的系统;设计文档,需要快速纵览项目时并无闲暇去阅览数万行代码;需求文档,乙方不可能按着你的 API 接口声明猜测你的意图……然而,几乎每一个程序员都被文档的匮乏深深伤害过。

[……]

阅读全文



言论自由的重要性

言论自由,加上由其衍生出来的信息自由、新闻自由,作为《世界人权宣言》的一部分,几乎包含在所有现代国家的立国方针——但本文无意对其进行宏观的定义,更不准备探讨相关的法律与实践。

那么,这篇文章要谈论些什么呢?

一个人,由其行为定义,而思维方式在各方各面决定了行为。好的思维方式,能够让人在瞬息万变、泥沙俱下的环境中作出最有利的抉择;而不良的思维方式,注定无法获得洞察世界的能力,从而昏招频出。

在我看来,「言论自由」是塑造良好思维方式之根基。

[……]

阅读全文


核心特性与亲密关系

亲密关系的追寻与建立,已是难事;而维持,更常常令人头疼。大多数的情况下,或是三天两头的争吵,让关系以彻底崩坏告终;或是同床异梦,最后关系名存实亡,好点的还能打个炮,坏点的只把对方当作生活里的赘肉。

什么样的人,能让我愿意长久地维持亲密关系——我在上上篇博文中给出了答案。但在那之后,我不时在想,是否有一种普适的规则,可以推导出每个人对完美伴侣的要求呢?[……]

阅读全文


提纯的情感

「我们坐在树杈上,下方是一望无际的大海。海风夹杂着春天的气息,还有你发丝上的苹果香气。就好像是晚春初夏,一切都快要开始的感觉。」

在听歌时无意间看到的一条评论,的确勾起了我的一丝遐想。我甚至在脑海中幻想了一下这个画面:并不会爬树的我,坐在一棵不存在的树上,眺望着没见过几次的大海;伊人倚靠身旁,[……]

阅读全文


方枘圆凿[2]:等效主义与良心

“方枘圆凿”是一个系列,希望这些文章能够阐述清一些古怪的现象,并给出相应的对策。
同系列的所有文章请点击下方的“方枘圆凿”标签查看。

上一篇文章里,我介绍了从小内化的“思想钢印”的不靠谱性。也就是从小被灌输的观念未必可靠,它的初衷或许是好的,但难免在长久的社会演变中发生了漂变,导致它失去了原有的功效却依然被强加于人。

这一篇文字里,我将会介绍(在我看来)在破除“思想钢印”的神圣性后,如何选择新的方向。[……]

阅读全文



口语中尴尬的文言

这几天军训,阴差阳错调到了匕首操表演方阵。感觉还是挺爽的……天天划水,可欢乐了。

嗯,既然是表演,最后肯定总要喊个口号吧。经过教官征集并挑选,选了一个:“成电载梦,素履以往。电科亮剑,尽显锋芒。”

嗯,我就不评判这个口号的整体效果了,在我看来总体效果只能算是平平。其中最令我不满意的,是第二句“素[……]

阅读全文


婚姻制度体现的社会不信任

本文没有意义。

婚姻,信任还是怀疑

“婚姻”在人们看来是一种信任的体现,是两个人对彼此关系的最高声明,千百年来受尽了歌颂。但同时无可否认的是,“婚姻”是一种对“不信任”的强制破除,这“不信任”未必发生在两人内部,更多的是来自他人与社会。

婚姻是一种关系的声明与担保,与签字画押加抵押并无二致。正[……]

阅读全文


Talk is VITAL

偶然间,又在一个博客的副标题栏上看到了此金句:“Talk is cheap, show me the code!”心中却有几分别扭。

talk 真的是 cheap 的吗?code 才是事关一切的吗?我觉得不尽然。

头一次看到这句话,还是在搞 OI 的那苦逼岁月里。这句话在 OI 圈子中似乎特别流[……]

阅读全文