paint-brush
Proglogging:开发人员的侦探工具包by@offcode
386
386

Proglogging:开发人员的侦探工具包

Adam Schmideg10m2023/10/09
Read on Terminal Reader

对于旧金山的软件开发人员 Marco 来说,早晨通常是从一杯热气腾腾的咖啡和滚动浏览最新的科技和文学新闻开始的。
featured image - Proglogging:开发人员的侦探工具包
Adam Schmideg HackerNoon profile picture
0-item
1-item

遗失的福尔摩斯手稿


这是一项在文学界引起轩然大波的惊人发现,一份以前不为人知的福尔摩斯故事手稿被出土了。这份手稿藏在伦敦历史悠久的布卢姆斯伯里区一栋维多利亚时代住宅的尘土飞扬的阁楼里,它不仅讲述了世界上最著名的侦探的不为人知的故事,还揭示了破案时使用的方法工具——一种结构化的方法。约翰·沃森(John Watson)将其称为“查询索引”。

发现

这份手稿是在一次例行的房地产拍卖中曝光的。这座房子原主人的最后一位在世亲戚是阿瑟·柯南·道尔爵士的远房表弟,他对藏在一个有百年历史的蒸汽船箱中的宝藏一无所知。直到一位专门从事古籍鉴定的鉴定师偶然发现了一堆用麻线整齐地捆着的泛黄纸张,才明白了这一发现的重大意义。

查询索引

这份手稿与其他福尔摩斯故事的不同之处在于,沃森博士使用一种他称之为“调查索引”的方法,对他们的调查过程进行了细致的记录。沃森似乎采用了这种结构化的日记形式,以有组织的方式对观察结果、问题和推论进行分类。该索引不仅仅是一个讲故事的工具,而且是叙述的一个组成部分,引导福尔摩斯和华生穿过复杂线索和转移注意力的迷宫。


“探究索引”的布局非常注重细节,用特定的动词来启动每个条目,既是行动点又是反思。沃森在手稿中的注释表明,他将“调查索引”视为一种通用工具,适用于各种形式的调查,而不仅仅局限于侦探工作。

影响

学者和粉丝都对福尔摩斯经典的这一新方面很感兴趣。著名维多利亚文学专家埃莉诺·休斯博士评论道:“探究索引为福尔摩斯-沃森的动态增添了一个全新的层面。这不仅仅是一种破案方法;这是一扇了解纪律严明的头脑的窗口,使他们成为终极侦探二人组。”


除了激发新的学术兴趣之外,“探究索引”作为结构化问题解决的永恒方法,还引起了从新闻调查到软件开发等各个领域的专业人士的关注。

下一步是什么?

由于正在努力验证手稿的真伪,如果确认属实,则将其发布给全世界,有一点是肯定的:“探究索引”有望成为未来几年讨论和改编的主题。这个曾经是维多利亚时代解决伦敦最令人困惑的谜团的工具可能很快就会发现自己成为 21 世纪关于分析思维和方法论严谨性对话的中心。


确实,这部失落的福尔摩斯手稿及其“探究索引”的发现,不仅丰富了我们对文学史的理解,而且提供了一个永恒的探究工具,再次证明有些方法,如传奇侦探,是不朽的。


当学者和文学爱好者热切地等待新发现的福尔摩斯手稿的出版时,我们有机会独家一睹故事的风采。这是一个充满悬念和脑力挑战的故事,它强调了约翰·沃森博士称为“探究索引”的结构化调查方法。这种解开谜团的创新方法让我们得以一睹伦敦最著名的侦探二人组背后的纪律严明的迷人风采。言归正传,我们向您呈现这个引人入胜的福尔摩斯失传故事的摘录,以及“调查索引”在解决维多利亚时代伦敦最令人困惑的案件之一中的作用。

查询索引案例

伦敦烟雾弥漫的街道上挤满了马车和行人,每个人都过着自己的一天,每个人都有一个故事要讲。然而,对于约翰·沃森博士来说,这一天是从一位战时老朋友对“查询索引”的独特介绍开始的。 “这是处理混乱的一种方法,约翰,”他的朋友递给他一本日记说道。沃森总是渴望找到更好的方式来记录他与神秘的夏洛克·福尔摩斯的冒险经历,他认为这可能是一个有趣的实验。


贝克街公寓熟悉的铃声响彻整个房间,标志着新客户的到来,不可避免地也意味着新案件的到来。一位心烦意乱的女士讲述了伦敦发生的一系列盗窃案——这些盗窃案看似无关,但却异常细致。


当福尔摩斯在房间里踱来踱去,抽着烟斗,目光茫然地陷入沉思时,华生趁机开始了他的查询索引之旅。


开头: “伦敦的精心盗窃案”。


沃森记下了最初的细节、日期、客户的名字和她的故事。福尔摩斯以其一贯的天赋,开始进行快速观察,推断出有关客户的事实、她的处境以及盗窃的性质。


注: “所有盗窃都发生在黄昏。没有强行进入的迹象。每件被盗物品都有一段历史、一个故事。”


福尔摩斯概述了参观盗窃现场的计划。


做: “参观哈灵顿勋爵的宅邸,第一个盗窃地点。”


当他们穿过哈林顿勋爵宅邸的豪华大厅以及后来东伦敦灯光昏暗的小巷时,沃森仔细地记录了他们的发现。每一个奇特的脚印,每一个街头小声的谣言,都会进入沃森的查询索引。


完成:二人结束了他们的访问,收集了大量信息,但拼图碎片并不完全吻合。


福尔摩斯罕见地显得心慌意乱。案子的线索悬在他聪明的头脑之外。沃森手里拿着日记,建议道:“也许我们应该回顾一下我们的发现?”


他们坐在壁炉旁,日记摊开。


问题: “为什么只有有历史的物品?有什么联系?”


当华生大声沉思时,福尔摩斯的手指敲击着扶手。


也许: “小偷可能试图改写历史吗?或者说,可以收回它吗?”


夜幕降临,壁炉的温暖光芒在墙壁上投射出舞动的影子。 “也许”的假设引导他们追寻了一系列古老的家族争斗、失去的遗产和伦敦隐藏的历史。


突破出现在黎明时分。一个以前被忽视的联系现在从查询索引的页面上瞪着他们。被盗物品都可以追溯到伦敦过去的一个事件:大火。


福尔摩斯和华生重新焕发活力,追赶领先,最终在伦敦的屋顶和狭窄的小巷进行了一场惊心动魄的追逐。原来,小偷是一个在火灾中失去一切的家族的后裔,他正试图找回丢失的文物,以恢复家族的荣誉。


亮点:沃森在反思他们的冒险经历时,将认识到与大火的联系标记为他们案件的转折点。


回到贝克街舒适的环境中,空气中弥漫着成就感。福尔摩斯仔细阅读了查询索引,说道:“华生,你的这个方法有它的优点。”


沃森微笑着,写下了当晚的最后一个条目。探究索引最初是一个实验,现在已经成为他们冒险中不可或缺的一部分。当伦敦沉睡时,夏洛克·福尔摩斯和华生医生的故事结构严谨、深思熟虑,等待着他们的下一个篇章。

夏洛克·福尔摩斯遇上 Proglogging

对于旧金山的软件开发人员 Marco 来说,早晨通常是从一杯热气腾腾的咖啡和滚动浏览最新的科技和文学新闻开始的。作为夏洛克·福尔摩斯的忠实粉丝,当他看到新发现的手稿采用了一种名为“查询索引”的独特方法的标题时,他睁大了眼睛。当他深入研究摘录时,他发现自己不仅对解开的谜团感兴趣,而且对约翰·沃森博士解决这个问题的系统方法感兴趣。


“探究索引”以其动词主导的条目和结构化的反思立即引起了马可的共鸣。在他充满无尽代码、调试会话和紧迫期限的世界里,混乱常常让人感到难以承受。维多利亚时代的方法能否为 21 世纪的软件开发挑战提供解决方案?


决心找出答案,Marco 决定将“查询索引”融入他的日常工作流程中。当他思考一个更现代、能与当今精通技术的专业人士产生共鸣的名字时,他想到了“Proglogging”这个术语——“编程”和“日志记录”的组合。


有了这个新工具,Marco 开始了他的下一个项目:为移动应用程序实现暗模式功能。他首先列出了他的 Proglogging 条目。

黑暗模式


估计:实现暗模式切换需要 4 小时。


开始:深色模式功能。


注意:最佳实践建议使用 CSS 变量和 JavaScript 切换来实现暗模式。


执行:为浅色主题定义 CSS 根变量。


完毕。


执行:创建相应的暗模式 CSS 变量。


完毕。


做法:使用localStorage实现 JS 切换功能以实现主题偏好。


完毕。


问:如何在模式之间平滑过渡?


注意:在颜色属性上使用 CSS 过渡。


要做:实现明暗模式之间的平滑过渡。


完毕。


添加:在各种浏览器上测试功能的兼容性。


要做:在右上角放置深色模式切换按钮并设置其样式。


完毕。


休息: 10 分钟的伸展休息。


执行:在本地环境中测试切换。


注意:切换可以工作,但图标更改有轻微延迟。


也许:优化图标加载或使用 SVG。


做法:用 SVG 替换图标来解决延迟问题。


完毕。


要做:将更改推送到暂存阶段以供团队审核。


完毕。


亮点:用 SVG 替换图标来解决延迟问题是一个关键举措。这一变化保证了流畅的用户体验,并凸显了性能优化的重要性。


预计:从 4 小时调整为 3 小时。功能实施比预期顺利。

传播这个词

随着他的进步,Marco 发现 Proglogging 不仅提供了一个结构化的待办事项列表,而且还详细记录了他的思维过程、挑战和成就。 “Do”和“Done”条目提供了清晰的行动框架,而“Note”和“Question”则允许反思和查询,否则这些可能会在快节奏的开发周期中丢失。


Marco 对 Proglogging 如何提高他的注意力和工作效率印象深刻,他无法把它留给自己。在一次团队会议上,他介绍了这种方法,并引用了它在福尔摩斯故事中的有趣起源。为了展示其实用性,他向他们介绍了他最近的黑暗模式项目,展示了每个 Proglogging 条目如何帮助他应对技术挑战和决策循环。


起初他的同事对此表示怀疑,但他们无法忽视黑暗模式功能的明显成功以及 Marco 新发现的热情。到了周末,Proglogging 已经成为团队任务管理的首选方法,不久其他部门就注意到了。

Proglogging 方法揭晓

看到人们对他的 Proglogging 方法越来越感兴趣,Marco 决定花时间阐明其核心组件和为他的团队以及最终为更广泛的受众带来的好处。下面是 Proglogging 方法的概述:

概述

Proglogging 提供了一种结构化的任务管理和反思方法。借鉴传统的日志记录和日记实践,它强调使用特定的动词来启动每个条目,确保文档的清晰度和目的。

关键部件

  • 单条目焦点:Proglogging 一次捕捉一个条目的想法,有助于清晰度并减少不知所措。
  • 动词主导的说明:每个条目都以指定的动词开头,确定条目的意图,无论是动作、观察还是里程碑。

核心动词

  • 注意:记录观察结果、见解或一般信息。
  • Do :指定即将进行的操作或任务。
  • 完成:标记前面“执行”条目的任务已完成。
  • 问题:标记不确定性或需要探索的领域。
  • 也许:针对一个值得注意的问题提出潜在的解决方案或假设。
  • 添加:介绍未来的任务或行动。
  • 亮点:强调重大成就或挑战。
  • 估计:预测任务可能需要的时间或精力。
  • 开始:表示特定任务或项目的开始。
  • 中断:标记工作流程中的暂停或间隔。

灵活性

虽然 Proglogging 的结构是基础性的,但它是为适应性而设计的。鼓励根据个人工作流程和偏好进行定制。

好处

  • 结构化思维:以动词为主导的方法促进有组织的思维。
  • 清晰度:任务、观察和反思都有明确的界限。
  • 适应性:适用于从软件开发到学术研究的各种专业场景。
  • 反思:鼓励内省并从经验中学习。

使用与注意事项

  • 从笔记本或数字工具开始。以所选动词开头制作一个条目并遵循其意图。
  • 突出显示:当您觉得已取得重大成就或某些事情未按预期发挥作用时添加突出显示。
  • 长时间的工作结束后,检查所有“完成”条目。选择一两个作为亮点来概括会议的精髓。
  • 通过扫描“添加”条目找到所有待处理的任务。
  • 核心动词是基础。您可以根据个人需求随意扩展或修改它们。随着时间的推移,用户会形成适合其工作流程的节奏和风格。

遗产仍在继续

从维多利亚时代伦敦的煤气灯街道到当代电脑屏幕的 LED 光芒,从沃森博士的“探究索引”到马可的 Proglogging 的旅程强调了结构化思维的持久力量。沃森博士曾经希望他的方法对后代有用,事实上,它已经应用于现代问题的解决。无论过去还是现在,这种方法都是人类聪明才智的证明,证明好的想法没有过期日期。



免责声明*:哦,我多么希望这个故事是真实的!但可惜的是,你读到的“新发现的福尔摩斯手稿”的故事纯粹是虚构的,是我想象深处编造出来的。据大家所知,阿瑟·柯南·道尔爵士死后并没有给我们带来任何惊喜。*


[该系列的下一个故事:当人工智能加入开发团队时]