Fix broken link in Writing style section of company handbook (#41525)
## Summary - Fixed a broken link in the "Writing style" section of the company handbook (`handbook/company/writing.md`) - The "Mister Rogersing" example link was pointing to the old URL (`/handbook/company/communications#what-would-mister-rogers-say`) which no longer exists - Updated it to the correct URL (`/handbook/company/writing#what-would-mister-rogers-say`) Built for [Michael Thomas](https://fleetdm.slack.com/archives/D0AL6RD36GL/p1773287035750919) by [Kilo for Slack](https://kilo.ai/features/slack-integration) Co-authored-by: kiloconnect[bot] <240665456+kiloconnect[bot]@users.noreply.github.com> Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
This commit is contained in:
co-authored by
kiloconnect[bot]
Mike Thomas
parent
63e6375c10
commit
894a735681
@@ -294,7 +294,7 @@ Fleet’s writing style is clear, simple, and welcoming. We use short sentences,
|
||||
|
||||
We avoid "[puffery](https://www.linkedin.com/pulse/puffery-adam-frankl%3FtrackingId=SBVWxzqXTBm9qlO7Rw3ddw%253D%253D/?trackingId=SBVWxzqXTBm9qlO7Rw3ddw%3D%3D)". For engineers, replace hype with real data. For business readers, translate it into clear outcomes such as time saved or return on investment. Links are better than long explanations, since they keep content short and point people to more detail when they need it.
|
||||
|
||||
Our approach is informed by [Paul Graham's essays on writing simply](http://www.paulgraham.com/simply.html) and the clarity and optimism of Mister Rogers. To see how tone can shift from formal or negative to simple and optimistic, [the "Mister Rogersing" example](https://fleetdm.com/handbook/company/communications#what-would-mister-rogers-say) is a practical illustration of how reframing can make complex or difficult ideas more approachable.
|
||||
Our approach is informed by [Paul Graham's essays on writing simply](http://www.paulgraham.com/simply.html) and the clarity and optimism of Mister Rogers. To see how tone can shift from formal or negative to simple and optimistic, [the "Mister Rogersing" example](https://fleetdm.com/handbook/company/writing#what-would-mister-rogers-say) is a practical illustration of how reframing can make complex or difficult ideas more approachable.
|
||||
|
||||
When in doubt, simplify. Read your draft, cut unnecessary words, and make it shorter. If something feels confusing, rewrite until it feels obvious.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user