程序员的生活与数据库文档生成

李小伟

大家好，我是李小伟，一个程序员。有人说程序员最怕什么？不是Bug，也不是代码，而是写文档！你们知道吗，写文档就像是吃青菜，明知道对身体好，但每次都想绕过去！

李小伟

我为了写文档，开了一个数据库文档生成工具，名字叫‘shigen’。我想，既然要痛苦，至少要让它变得简单一点。谁知道，一打开它，连我自己都被它的复杂性吓到了！这简直是程序员的自我折磨啊！

李小伟

所以，我对我的同事们说：“看，写文档也不是那么难的事情，我们只需要把SQL语句输进去，然后等着它生成一大堆文字，绝对让你感受到程序员的无奈！”然后大家都沉默了，盯着我，似乎在说：“你能不能先用这个工具写一写我们的工资单……”

李小伟

说到数据库文档生成，大家有没有发现，程序员其实就是在记录自己的成长过程。每一段代码，都是我们生活的点滴！所以当我看到文档上写着‘字段A是为了解决问题而生’，我心里在想：这个字段还真是我内心深处的写照啊！

李小伟

而当我生成的文档最终显示出‘字段B是为了应对客户的反馈而设计’的时候，我真的是想哭！这就是程序员的宿命！我们永远在客户端和后端之间游走，仿佛身处两种人生，文档里是我们的痛苦与智慧。

李小伟

问大家一个问题，你们觉得程序员的文档好不好写？（停顿）我觉得就像是写诗，写得好，别人觉得你是天才；写得不好，大家就会说：你连文档都写不好，代码还能信任吗？

李小伟

编程有时候就像谈恋爱，最初的一见钟情让你沉迷，写代码的时候满脑子都是甜蜜的未来，但等到Bug出现的时候，你就会怀疑人生了。

李小伟

你们有没有发现，一段代码像极了感情的起伏？你明明写得好好的，忽然间就出错了，然后你开始追溯，发现原来是一个小小的拼写错误，就像是因为一个小脾气分手了一样！

李小伟

所以我学会了，每当我的代码出错，我就告诉自己：没关系，就像爱情一样，修复它就好，搞定它，下一次一定会更好！

李小伟

说到用户反馈，大家有没有收到过那种让人哭笑不得的反馈？我有一次收到一个客户的反馈：“为什么我的文档里有乱码？”我心想，我这是在写文档，还是在写小说，怎么会有乱码呢？

李小伟

后来我才知道，原来客户在用Word打开Markdown格式的文档！我说，亲爱的用户，我的文档是用来记录你们的需求的，不是用来考验你们的阅读技巧的！

李小伟

所以，现在我每次写文档之前，都会先给自己设定一个目标：不让用户在阅读时崩溃！而且，最好让他们懂得我写的每一个字，毕竟我是为了他们的代码而战斗！