每个数据集里都有一堆没写下来的决定:这个类别为什么要合、那个月为什么缺、过滤器为什么排除了一个看着无害的取值。
它们住在某个人的记忆里。那个人换了团队,数据集还在跑,但已经没人能维护它了。
必须写下来的
- 单位:一行到底是什么
- 过滤器,按顺序,带理由
- 已知缺口,以及它们是怎么来的
- 那些「差点走了另一条路」的决定
- 每一个决定是哪天做的
第四项在以后最省时间。一个没被记录的「险胜」,每年都会被重新吵一遍。
写在数据旁边
一个不从数据链过去的 wiki 页面,是没人会读的页面。说明应该和集合放在一起,一起版本化,一起交付。
把交接做成一次考试
把文档给一个从没见过这个集合的人,让他不求助地回答五个关于它的问题。答不上来的那些,是文档的缺口,不是他的。
把查询写进去
最常跑的那三条查询,写出来。它们是进入一个集合最快的方式,也是最难重建的东西。
Zovda 通过 Datuva 交付每一批数据时,把这些决定一起附上,团队换人不会变成含义换人。语料总目录展示了这个格式。
告诉我们还有什么没人写下来,我们会在 1 个工作日内回复。
