我敢打赌你没有写开发日志:你应该写开发日志的 3 个理由
由 Mux 主办的 DEV 全球展示挑战赛:展示你的项目!
“你知道怎么解决这个奇怪的原始神灵问题吗?”我曾经在办公室里被人这样问过。
这件事听起来有点耳熟,于是我快速翻阅了一下我的工作日志,果然找到了三个月前的一条笔记,上面我当时也遇到过这个问题,并记下了解决方法。
“你运行的 Node 版本与该应用程序不匹配。”我自信地回答道。
我看起来像个超级英雄,居然记住了所有事情,其实我只是回顾了一下我每天记笔记的外部知识库,然后把它复述出来。这次的问题名称很酷(这也是我选择它作为主要例子的原因),这确实帮了我不少忙。但如果是我在工作中遇到的问题,几乎任何相关的搜索词都适用。
记工作日志的价值非常大,原因如下。
你没必要看。
你可能会觉得日记是用来以后翻阅的。但实际上并非如此,它是一个可搜索的知识库,其中一项信息就是事件发生的日期。不必担心它读起来是否有趣或像个故事,它只是你一天中记录的笔记、事件、错误信息和解决方案,这些在未来都可能派上用场。
这是一个数据库
它实际上是一个数据库,一个结构松散、高度可搜索的数据库,能够让你的开发经验随着时间的推移而不断增值。你投入的信息越多,它的价值就越高,因为我们的记忆力实在太差了。每一条信息都会与其他信息碎片建立联系,突出你可能错过的链接。.htaccess在我的数据库中搜索,会找到旧项目的重写规则,让我想起那些我早已遗忘的旧项目,还会突出显示一些与主题相关的零碎信息,从而唤起我的记忆,比如当年通过 FTP 连接到线上服务器,在没有 YAML 代码的情况下紧急修复 PHP bug 的那种恐惧感git commit——真是美好的回忆!
它能增强你的自信心。
我们常常忘记自己已经走了多远,只关注当下所处的时空点,而忽略了我们正在走的路线和轨迹。拥有知识储备,无论多么杂乱无章、看似零散,都能让我们看到自己走了多远,解决了多少问题,克服了多少困难。
作为数字内容创作者,我们的大部分工作都是不可见的🙁
当我的妻子看到一辆来自高端跑车公司的汽车驶过时,她会想起自己为这辆车的研发所付出的努力;当我的朋友开车经过某些桥梁时,他可以看到自己工作的实物成果。
另一方面,我看不到我在第一份工作中花费数月时间进行的数据库迁移或API重写。但是,我可以查看我的工作日志,看到我在那份工作中学到的知识、掌握的技巧以及应用的最佳实践,因为我把所有这些都记录了下来。
什么都行
别太纠结用什么工具,只要搜索功能好,文本文件就够用了。目前我最喜欢的应用是Notion。Evernote曾经风靡一时,现在Obsidian也成了新宠。只要它能让你快速记录,搜索功能强大,而且不会妨碍你使用,那就足够用了!
所以,快去写日记吧!
文章来源:https://dev.to/allthecode/i-bet-you-don-t-keep-a-developer-journal-3-reasons-you-should-4kn3