From 07697fa5dfe715ea9b6cbfd92c228717e796cf47 Mon Sep 17 00:00:00 2001 From: "kilo-code-bot[bot]" <240665456+kilo-code-bot[bot]@users.noreply.github.com> Date: Tue, 12 May 2026 08:53:17 -0700 Subject: [PATCH] Add "Why think like a historian?" section to handbook (#45224) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary - Adds a new "Why think like a historian?" section to the [Why this way?](https://fleetdm.com/handbook/company/why-this-way) handbook page. - Explains why docs, issues, and plans should include context beyond bare task descriptions — making them more discoverable in search, more accessible for others to understand and contribute to, and more useful for the company now and in the future. - Includes a concrete before/after example: an agenda for a meeting improved from "Write up scavenger hunt" to "Write up scavenger hunt for SF party on May 12 celebrating launch." Built for [Mike McNeil](https://fleetdm.slack.com/archives/C03U703J0G5/p1778589572377249?thread_ts=1778588885.302819&cid=C03U703J0G5) by [Kilo for Slack](https://kilo.ai/slack) --------- Co-authored-by: kiloconnect[bot] <240665456+kiloconnect[bot]@users.noreply.github.com> Co-authored-by: Mike McNeil --- handbook/company/why-this-way.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/handbook/company/why-this-way.md b/handbook/company/why-this-way.md index 14bf63fd8b..bf6f689f0b 100644 --- a/handbook/company/why-this-way.md +++ b/handbook/company/why-this-way.md @@ -481,6 +481,11 @@ Instead, the invited attendees on a calendar event are the people who are mandat Every internal meeting is inherently "optional" in the sense that if it's not a good use of time to [help the company](https://fleetdm.com/handbook/company#results), people should focus on results instead. +## Why think like a historian? + +When choosing a title for Google docs at Fleet, include enough context that someone in the future can understand not just _what_ is being discussed, but _why_ it matters and how it fits in. This is especially important for meeting agendas. A bare Google Doc title like "Write up scavenger hunt" is hard to find in search and can be difficult for other people to learn from or contribute to. Compare that with "Write up scavenger hunt for SF party on May 12 celebrating announcement" — now anyone who finds the doc later knows the purpose of the meeting, without needing to ask. This makes the Google doc more discoverable in search, more accessible, and more useful for everyone at the company — now and in the future. + + #### Stubs The following stubs are included only so that old links continue to work (for backwards compatibility.)