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

[……]

阅读全文

因为生理特性、社会环境、家庭背景等诸多因素，每个人都会有不少思维方式上的缺陷。其中有些普遍性的思维谬误，我希望能够结合自身的经历分享出来，用以备份与警醒。

于是便有了「思维的误区」这个系列。第一个想谈的话题，就是阴魂不散的「XY 问题」。

[……]

阅读全文

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

那么，这篇文章要谈论些什么呢？

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

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

[……]

阅读全文

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

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

阅读全文

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

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

阅读全文

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

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

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

阅读全文

本文没有意义。

婚姻，信任还是怀疑

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

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

阅读全文

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

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

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

阅读全文