Discharge7443/fleet
1
0
Fork 0
Code Issues Pull Requests Actions 22 Packages Projects Releases Wiki Activity

Add "Why think like a historian?" section to handbook (#45224)

Browse Source 
## 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 <mikermcneil@users.noreply.github.com>
This commit is contained in:
kilo-code-bot[bot]
2026-05-12 08:53:17 -07:00
committed by GitHub
co-authored by kiloconnect[bot] Mike McNeil
parent a913a5eebf
commit 07697fa5df
1 changed files with 5 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
handbook/company/why-this-way.md
+5
View File
@@ -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.)