paint-brush
プログログ: 開発者の探偵ツールキット@offcode
406 測定値
406 測定値

プログログ: 開発者の探偵ツールキット

Adam Schmideg10m2023/10/09
Read on Terminal Reader

長すぎる; 読むには

サンフランシスコを拠点とするソフトウェア開発者のマルコさんの朝は、通常、湯気の立つコーヒーを飲みながら、最新のテクノロジーや文学のニュースをスクロールすることで始まりました。
featured image - プログログ: 開発者の探偵ツールキット
Adam Schmideg HackerNoon profile picture
0-item
1-item

シャーロック・ホームズの失われた原稿


文学界に波紋を広げた驚くべき発見として、これまで知られていなかったシャーロック・ホームズ物語の原稿が発掘された。ロンドンの歴史的なブルームズベリー地区にあるビクトリア朝時代の邸宅のほこりっぽい屋根裏部屋に隠されたこの原稿は、世界で最も有名な探偵の知られざる物語を提供するだけでなく、事件を解決するために使用された方法論的ツール、つまり博士が体系化されたアプローチも明らかにしています。ジョン・ワトソンは「問い合わせインデックス」と呼んでいます。

発見

この原稿は定期的な不動産売却中に明らかになった。この家の元の所有者の最後の生きている親戚、アーサー・コナン・ドイル卿の遠いいとこは、100年前の汽船のトランクに隠された宝物についてまったく知りませんでした。古書を専門とする鑑定士が偶然、麻ひもできれいに縛られた黄ばんだ紙の束を見つけて初めて、この発見の記念碑的な重要性が理解されました。

問い合わせインデックス

この原稿が他のホームズ物語と異なる点は、ワトソン博士が「調査インデックス」と名付けた方法を使用して彼らの調査プロセスを綿密に記録していることです。ワトソンは観察、質問、推論を組織的にカタログ化するために、この構造化された形式のジャーナリングを採用したかのように見えます。インデックスは単なるストーリーテリングデバイスではなく、物語の不可欠な部分であり、複雑な手がかりと赤いニシンの迷路を通してホームズとワトソンを導きます。


「問い合わせインデックス」は細部にまで細心の注意を払ってレイアウトされており、各エントリの開始に特定の動詞を使用しており、アクション ポイントと考察の両方として機能します。原稿内のワトソンのメモは、彼が「捜査インデックス」を単に探偵業務に限定されるものではなく、さまざまな形式の捜査に適応できる普遍的なツールとして見ていたことを示唆しています。

意味するところ

学者もファンも同様に、ホームズ正典のこの新たな側面に興味をそそられています。著名なビクトリア朝文学の専門家であるエレノア・ヒューズ博士は次のように述べています。それは単に事件を解決するための手段ではありません。それは、彼らを究極の探偵デュオにした、規律ある精神への窓です。」


「インクワイアリ・インデックス」は、新たな学術的関心を呼び起こすだけでなく、構造化された問題解決のための時代を超越した方法として、調査報道からソフトウェア開発に至るまで、さまざまな分野の専門家の注目を集めています。

次は何ですか?

原稿を認証し、本物であることが確認されれば世界に向けて公開する取り組みが進められているが、一つ確かなことは、「調査インデックス」は今後何年にもわたって議論と改作の対象となることが約束されているということである。かつてビクトリア朝時代にロンドンの最も複雑な謎を解決するためのツールであったものが、間もなく分析的思考と方法論の厳密さに関する 21 世紀の対話の中心となるかもしれません。


実際、この失われたシャーロック・ホームズの原稿とその「調査索引」の発見は、文学史に対する私たちの理解を豊かにするだけでなく、時代を超越した調査ツールを提供し、伝説の探偵のようないくつかの手法が不滅であることを再び証明しました。


学者や文学愛好家が新たに発見されたシャーロック・ホームズの原稿の出版を心待ちにしている中、私たちはその物語を独占的に垣間見ることができます。サスペンスと知的な挑戦に富んだ物語は、ジョン・ワトソン博士による「調査インデックス」と呼ばれる構造化された調査方法に焦点を当てています。謎を解明するこの革新的なアプローチは、ロンドンで最も有名な探偵コンビの背後にある規律ある精神を興味深い垣間見ることができます。早速、シャーロック・ホームズの失われたこの魅惑的な物語からの抜粋と、ビクトリア朝のロンドンで最も複雑な事件の 1 つを解決する際の「捜査インデックス」の役割を紹介します。

問い合わせインデックスの場合

ロンドンのスモッグした通りは馬車と歩行者で賑わっており、それぞれが語るべき物語を持って一日を過ごしていた。しかし、ジョン・ワトソン博士にとって、その日は戦時中の旧友による「インクワイアリ・インデックス」と呼ばれるものの奇妙な紹介で始まりました。 「これは混乱を乗り切る方法だよ、ジョン」と友人は言い、彼に日記を手渡した。ワトソンは、謎めいたシャーロック・ホームズとの冒険を記録するためのより良い方法を見つけることにいつも熱心で、これは興味深い実験かもしれないと考えた。


ベイカー街のアパートでおなじみのチャイムが部屋中に鳴り響き、新しい顧客の到着、そして必然的に新たな事件の発生を告げた。取り乱した女性は、ロンドン中で起きた一連の盗難について語った。一見無関係に見えるが、不気味なほど綿密に行われた盗難だった。


ホームズがパイプを吸いながら部屋を歩き回り、目を遠くにして考え事をしていると、ワトソンはこの機会を利用して調査インデックスの旅を始めた。


開始: 「ロンドンの綿密な窃盗」。


ワトソンは、最初の詳細、日付、クライアントの名前、そして彼女の話を書き留めました。ホームズはいつもの才能で迅速な観察を開始し、依頼人、彼女の状況、盗難の性質に関する事実を推測し始めました。


注: 「すべての盗難は夕暮れ時に発生しました。強制侵入の形跡はない。盗まれたアイテムにはそれぞれ歴史と物語がありました。」


ホームズは盗難現場を訪れる計画を説明した。


実行: 「最初の盗難現場であるハリントン卿の邸宅を訪ねてください。」


彼らがハリントン卿の邸宅の豪華な広間を歩き回り、その後東ロンドンの薄暗い路地を歩き回りながら、ワトソンは彼らの発見を注意深く記録した。あらゆる奇妙な足跡、街でささやかれたあらゆる噂が、ワトソンの調査インデックスに入りました。


完了:二人は豊富な情報を収集して訪問を終えましたが、パズルのピースが完全にはまりませんでした。


ホームズは珍しく慌てた様子だった。事件の糸は彼の聡明な頭脳の届かないところにぶら下がっていた。ワトソンは日記を手に、「我々の調査結果を再検討すべきではないだろうか?」と提案した。


彼らは暖炉のそばに座り、日記を広げた。


質問: 「なぜ歴史のあるアイテムだけを選ぶのですか?」何の関係があるの?」


ワトソンが声を出して考えている間、ホームズの指が肘掛けをたたいた。


おそらく、 「もしかして泥棒は歴史を書き換えようとしているのだろうか?」それとも取り戻すかも?」


夜が更け、暖炉の暖かな光が壁に踊る影を落としました。 「もしかしたら」という仮説は、彼らを古い家族の確執、失われた遺産、そしてロンドンの隠された歴史の道へと導きました。


突破口は夜明けに訪れた。以前は見落とされていたつながりが、現在、調査索引のページから彼らに睨まれています。盗まれた品物はすべて、ロンドンの過去に起きた単一の出来事、つまり大火に遡るものでした。


ホームズとワトソンは新たな活力を持って先頭を追い、ロンドンの屋根や狭い路地を横切るスリリングな追跡劇で最高潮に達した。結局のところ、その泥棒は火災ですべてを失った家族の子孫であり、家族の名誉を回復するために失われた遺物を取り戻そうとしていました。


ハイライト:ワトソンは、彼らの冒険を振り返り、大火との関連性の認識を彼らの事件の転換点としてマークしました。


ベーカー街の居心地の良い空間に戻ると、達成感が空気に満ちていました。ホームズは調査索引に水を注ぎながら、「ワトソン、あなたのこの方法には利点があります。」と述べた。


ワトソンは微笑みながら、その夜の最後のエントリーを書き留めた。当初は実験だったインクワイアリー・インデックスは、今では彼らの冒険に欠かせない一部となった。ロンドンが眠っている間、シャーロック・ホームズとワトソン博士の、構造化され思索的な物語が次の章を待っていました。

シャーロック・ホームズとプログロッギングの出会い

サンフランシスコを拠点とするソフトウェア開発者のマルコさんの朝は、通常、湯気の立つコーヒーを飲みながら、最新のテクノロジーや文学のニュースをスクロールすることで始まります。シャーロック・ホームズの熱烈なファンである彼は、「調査索引」と呼ばれる独自の方法を特徴とする新たに発見された原稿に関する見出しを見たときに目を丸くしました。彼はその抜粋を詳しく調べていくうちに、解明された謎だけでなく、それを解決するためのジョン・ワトソン博士の体系的なアプローチにも興味をそそられていることに気づきました。


動詞主導のエントリと構造化された考察を備えた「インクワイアリ インデックス」は、すぐにマルコの共感を呼びました。終わりのないコード、デバッグ セッション、厳しい締め切りに囲まれた彼の世界では、混乱に圧倒されることがよくありました。ビクトリア朝時代の手法が 21 世紀のソフトウェア開発の課題の解決策となるでしょうか?


マルコは、それを知りたいと決意し、「問い合わせインデックス」を日々のワークフローに取り入れることにしました。彼は、今日のテクノロジーに精通した専門家の共感を呼ぶような、より現代的な名前を考えていたときに、「プログラミング」と「ロギング」を組み合わせた造語である「プログロギング」という用語が頭に浮かびました。


この新しいツールを武器に、マルコはモバイル アプリケーションにダーク モード機能を実装するという次のプロジェクトに着手しました。彼はプログロギングのエントリをレイアウトすることから始めました。

ダークモード


推定:ダーク モードの切り替えを実装するには 4 時間。


開始:ダークモード機能。


注:ベスト プラクティスでは、ダーク モードを実装するために CSS 変数と JavaScript トグルを使用することをお勧めします。


推奨事項:ライト テーマの CSS ルート変数を定義します。


終わり。


実行:対応するダーク モード CSS 変数を作成します。


終わり。


実行:テーマ設定のためにlocalStorageを使用して JS トグル関数を実装します。


終わり。


質問:モード間をスムーズに移行するにはどうすればよいですか?


注:カラープロパティには CSS トランジションを使用します。


実行:ライト モードとダーク モードの間のスムーズな移行を実装します。


終わり。


追加:さまざまなブラウザーで機能の互換性をテストします。


推奨:右上隅にあるダーク モード切り替えボタンの位置とスタイルを設定します。


終わり。


休憩: 10分間のストレッチ休憩。


実行:ローカル環境で切り替えをテストします。


注:トグルは機能しますが、アイコンの変更に若干の遅れが生じます。


おそらく:アイコンの読み込みを最適化するか、SVG を使用します。


実行:遅延を解決するには、アイコンを SVG に置き換えます。


終わり。


実行:チームのレビューのために変更をステージングにプッシュします。


終わり。


ハイライト:遅延を解決するためにアイコンを SVG に置き換えることは極めて重要な措置でした。この変更により、スムーズなユーザー エクスペリエンスが確保され、パフォーマンスの最適化の重要性が強調されました。


推定: 4時間から3時間に調整。機能の実装は予想よりもスムーズでした。

言葉を広める

マルコは、学習を進めるにつれて、プログロギングが構造化された To Do リストだけでなく、彼の思考プロセス、課題、成果の微妙な記録を提供してくれることに気づきました。 「Do」と「Done」のエントリはアクションのための明確な枠組みを提供し、「Note」と「Question」はペースの速い開発サイクルでは失われる可能性のある考察や質問を可能にします。


プログロッギングによって集中力と生産性が向上したことに感銘を受けたマルコは、それを独り占めすることができませんでした。チームミーティング中に、彼はその興味深い起源がシャーロック・ホームズの物語にあることを引用しながら、この手法を紹介した。その有用性を実証するために、彼は最近のダーク モード プロジェクトについて説明し、Proglogging の各エントリが技術的な課題や意思決定のループを乗り越えるのにどのように役立ったかを紹介しました。


当初は懐疑的でしたが、同僚たちはダーク モード機能の明らかな成功と、マルコが新たに見出した熱意を無視できませんでした。週末までに、Proglogging はチームのタスク管理の頼りになる方法となり、他の部門が注目するまでに時間はかかりませんでした。

プログロギング手法が明らかに

彼のプログロッギング手法への関心が高まっているのを見て、マルコは時間をかけて、その中核的なコンポーネントとチームにとっての、そして最終的にはより幅広い聴衆にとっての利点を明確に説明することにしました。以下は、Proglogging メソッドの概要です。

概要

Proglogging は、タスク管理と振り返りに対する構造化されたアプローチを提供します。従来のログ記録とジャーナリングの慣行を借用し、各エントリを開始する特定の動詞の使用を強調し、ドキュメントの明確さと目的を確保します。

主要コンポーネント

  • 単一エントリ フォーカス: プログログでは、一度に 1 エントリずつ思考をキャプチャし、明晰性を高め、圧倒されるのを軽減します。
  • 動詞主導の指示: 各エントリは指定された動詞で始まり、アクション、観察、マイルストーンなどのエントリの意図を確立します。

コア動詞

  • : 観察、洞察、または一般的な情報を文書化します。
  • Do : 差し迫ったアクションまたはタスクを指定します。
  • Done : 前の「Do」エントリからのタスクの完了をマークします。
  • 質問: 不確実性または調査が必要な領域にフラグを立てます。
  • たぶん: 注目された懸念に対して潜在的な解決策または仮説を提案します。
  • 追加: 今後のタスクまたはアクションを導入します。
  • ハイライト: 重要な成果や課題を強調します。
  • 見積もり: タスクにかかる時間または労力を予測します。
  • Start : 特定のタスクまたはプロジェクトの開始を知らせます。
  • Break : ワークフロー内の一時停止または間隔をマークします。

柔軟性

Proglogging はその構造が基本的ですが、適応性を考慮して設計されています。個々のワークフローや好みに合わせて調整することをお勧めします。

利点

  • 構造化された思考: 動詞主導のアプローチは、組織化された思考を促進します。
  • 明確さ: タスク、観察、考察が明確に区別されています。
  • 適応性: ソフトウェア開発から学術研究まで、さまざまな専門的シナリオに適用できます。
  • 振り返り: 内省と経験からの学習を奨励します。

使用方法と注意事項

  • ノートブックまたはデジタルツールから始めます。選択した動詞で始まるエントリを作成し、その意図に従います。
  • ハイライト: 重要な成果が達成されたと感じた場合、または何かが期待どおりに機能しなかった場合にハイライトを追加します。
  • 長時間の作業セッションの後、すべての「完了」エントリを確認します。セッションの本質を要約するハイライトとして 1 つまたは 2 つを選択します。
  • 「追加」エントリをスキャンして、保留中のタスクをすべて見つけます。
  • コア動詞は基礎です。個々のニーズに応じて自由に拡張または変更してください。時間が経つにつれて、ユーザーは自分のワークフローに合わせたリズムとスタイルを身につけます。

レガシーは続く

ビクトリア朝のロンドンのガス灯の通りから現代のコンピューター画面の LED の輝きまで、ワトソン博士の「調査インデックス」からマルコのプログロッギングまでの旅は、構造化された思考の永続的な力を強調しています。ワトソン博士はかつて自分の手法が将来の世代に役立つことを望んでいましたが、実際にそれは現代の問題解決に活かされています。当時も今も、この方法は人間の創意工夫の証として機能し、良いアイデアには有効期限がないことを証明しています。



免責事項*: ああ、この話が本当だったらいいのにと思います。しかし残念ながら、あなたが読んだ「新たに発見されたシャーロック・ホームズの原稿」に関する物語は、私の想像力の奥底から紡ぎ出された純粋なフィクションです。誰もが知る限り、サー・アーサー・コナン・ドイルは私たちに死後何のサプライズも送っていない。*


[シリーズの次のストーリー: AI が開発チームに加わるとき]