<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.4.1">Jekyll</generator><link href="https://blog.doismellburning.co.uk/feed.xml" rel="self" type="application/atom+xml" /><link href="https://blog.doismellburning.co.uk/" rel="alternate" type="text/html" /><updated>2026-08-03T04:36:06+00:00</updated><id>https://blog.doismellburning.co.uk/feed.xml</id><title type="html">Kristian Glass - Do I Smell Burning?</title><subtitle>I write. I try to make sure the good stuff ends up here.</subtitle><author><name>Kristian Glass</name></author><entry><title type="html">The case for hero paragraphs at the top of your CV</title><link href="https://blog.doismellburning.co.uk/the-case-for-hero-paragraphs-at-the-top-of-your-cv/" rel="alternate" type="text/html" title="The case for hero paragraphs at the top of your CV" /><published>2025-03-20T23:36:00+00:00</published><updated>2025-03-20T23:36:00+00:00</updated><id>https://blog.doismellburning.co.uk/the-case-for-hero-paragraphs-at-the-top-of-your-cv</id><content type="html" xml:base="https://blog.doismellburning.co.uk/the-case-for-hero-paragraphs-at-the-top-of-your-cv/"><![CDATA[<p>A lot of folks’s CVs open with a short paragraph of self-descriptive prose about them.
I heard them called “hero paragraphs” somewhere (presumably something like “why you’re the hero of the story” or something) and I like the name so I’m going to keep using it.</p>

<p>I think these are valuable tools and if your CV doesn’t have one, then I think you should strongly consider changing that.</p>

<!-- more -->

<p><strong>They’re your “elevator pitch” in text form</strong>.
They’re your space to say “hey, this is me, this is why you want to work with me” - freeform text saying whatever you choose.
Take the space, use the opportunity, and pitch.</p>

<p><strong>They add colour and context</strong>.
The bulk of most CVs is facts - positions, skills, experience.
Your hero paragraph is an opportunity to tie that all together in a neat package for the reader - are you a “freelancer and consultant with a focus on algorithmically-complex backend systems”, or an “infrastructure engineer with significant experience in FinTech and other regulated environments” or something else entirely? Say so!</p>

<p><strong>They put the most important information first</strong>.
Get your message across clearly and concisely and early, and let the rest of your CV follow up with more detail.
Hiring managers and other readers can be busy, they can miss things, they can be juggling tonnes of CVs at once - make their lives easier by giving them the key things up front.</p>

<p><strong>They let you shape the narrative</strong>.
You can’t change your past, but you can choose how you present it.
Maybe you had a few recent short stints in places and you’re concerned about being seen as flighty - well you also have “experience across a range of organisations”.
Maybe your heart is in hands-on software engineering but you spent the last two years as a manager to see if you liked it - you’re “an experienced software engineer with management experience” so when someone starts reading about your previous roles they don’t think you’ve applied for the wrong thing when they see the most recent.</p>

<p>So if your CV doesn’t have a hero paragraph, I think it’s well worth the time to change that.
Spend a few minutes on a sentence or two to really make clear who you are and why you’re awesome.</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[A lot of folks’s CVs open with a short paragraph of self-descriptive prose about them. I heard them called “hero paragraphs” somewhere (presumably something like “why you’re the hero of the story” or something) and I like the name so I’m going to keep using it. I think these are valuable tools and if your CV doesn’t have one, then I think you should strongly consider changing that.]]></summary></entry><entry><title type="html">Incidents are like dirty nappies</title><link href="https://blog.doismellburning.co.uk/incidents-are-like-dirty-nappies/" rel="alternate" type="text/html" title="Incidents are like dirty nappies" /><published>2025-01-12T00:11:00+00:00</published><updated>2025-01-12T00:11:00+00:00</updated><id>https://blog.doismellburning.co.uk/incidents-are-like-dirty-nappies</id><content type="html" xml:base="https://blog.doismellburning.co.uk/incidents-are-like-dirty-nappies/"><![CDATA[<p>The start of this year sees me thinking about KPIs and goals for my engineering org in my role as VP of Engineering,
while also reading a book on potty training in my role as “Daddy”.</p>

<p>As such, the following analogy occurred to me,
and now I inflict it upon you:</p>

<!-- more -->

<h2 id="dealing-with-an-incident-is-like-dealing-with-a-dirty-nappy">Dealing with an incident is like dealing with a dirty nappy</h2>

<ul>
  <li>It’s tempting to think of them as “bad” but fundamentally they’re a healthy and natural, if unglamorous, process</li>
  <li>You want them somewhat regularly - too often is bad, but so is too rarely</li>
  <li>Sometimes they go really smoothly and it’s great</li>
  <li>Sometimes they can be a bit gnarly</li>
  <li>Sometimes they go so badly you want to just burn it all down and run away screaming</li>
  <li>If your other processes are healthy, they’re more likely to go better</li>
  <li>You aim to be prepared for them and have them in a comfortable place, but sometimes they surprise you in the early hours of the morning when you’re somewhere you really don’t want to be (thanks twom)</li>
  <li>Having other folks with you for support is really helpful</li>
  <li>Sometimes, whether you like it or not, you get pooped on (thanks twom)</li>
</ul>

<p>Fundamentally incidents are a fact of life for an engineering org, and dirty nappies a fact of life for the parents of a small child.
It’s how you deal with them that counts!</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[The start of this year sees me thinking about KPIs and goals for my engineering org in my role as VP of Engineering, while also reading a book on potty training in my role as “Daddy”. As such, the following analogy occurred to me, and now I inflict it upon you:]]></summary></entry><entry><title type="html">2023 In Books</title><link href="https://blog.doismellburning.co.uk/2023-in-books/" rel="alternate" type="text/html" title="2023 In Books" /><published>2024-11-28T18:30:00+00:00</published><updated>2024-11-28T18:30:00+00:00</updated><id>https://blog.doismellburning.co.uk/2023-in-books</id><content type="html" xml:base="https://blog.doismellburning.co.uk/2023-in-books/"><![CDATA[<p><a href="https://blog.doismellburning.co.uk/2022-in-books/">As per 2022</a>,
some things I read in 2023,
along with some brief opinions/recommendations.</p>

<p>All categorisations are approximate at best and will probably cause some kind of contention.</p>

<!-- more -->

<h2 id="fiction">Fiction</h2>

<ul>
  <li><a href="https://amzn.to/4i6yygh">Garon Whited’s Nightlord series (4-7)</a> - I’m starting to lose track a bit of all the parallel worlds, but it’s still nice to immerse myself in the fiction of smoothly-progressing well-funded projects(!)</li>
  <li><a href="https://amzn.to/3ZdeAb0">Charles Stross’s Season of Skulls</a></li>
  <li><a href="https://amzn.to/4eWFzNL">Lois McMaster Bujold’s Shards of Honour and Barrayar (Vorkosigan Saga 1-2)</a> - finally sat down to read these after so many recommendations, and it was so very worth it - lots of fun!</li>
  <li><a href="https://amzn.to/4g9FoQe">Yoon Ha Lee’s Hexarchate Stories (The Machineries of Empire 3.5)</a> - a collection of short stories set in the Hexarchate</li>
  <li><a href="https://amzn.to/4eWFzNL">Sarah J. Maas’s A Court of Thorns and Roses (1-5)</a> - so so much fun - more explicit than I first expected, but also really engaging and easy-to-read fantasy</li>
</ul>

<h2 id="non-fiction">Non-Fiction</h2>

<ul>
  <li><a href="https://amzn.to/417ti5R">Christina Wodtke’s Radical Focus : Achieving Your Most Important Goals with Objectives and Key Results</a> - I’m a big fan of OKRs, and this book does a fantastic job of laying out reasoning, considerations, and pitfalls - I’d strongly recommend it to anyone looking at OKRs or similar</li>
  <li><a href="https://amzn.to/3OqhT9Y">The Secret Barrister’s Nothing But The Truth: Dark Humour and Shocking Truths Learned from a Life in the Law</a></li>
  <li><a href="https://amzn.to/4i6PLWW">TransFighters Oakland’s A Self-Defense Study Guide for Trans Women and Gender Non-Conforming / Nonbinary AMAB Folks</a> - a friend of a friend was involved in the production, so I picked up a copy - interesting and insightful</li>
</ul>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[As per 2022, some things I read in 2023, along with some brief opinions/recommendations. All categorisations are approximate at best and will probably cause some kind of contention.]]></summary></entry><entry><title type="html">2022 In Books</title><link href="https://blog.doismellburning.co.uk/2022-in-books/" rel="alternate" type="text/html" title="2022 In Books" /><published>2024-11-28T00:30:00+00:00</published><updated>2024-11-28T00:30:00+00:00</updated><id>https://blog.doismellburning.co.uk/2022-in-books</id><content type="html" xml:base="https://blog.doismellburning.co.uk/2022-in-books/"><![CDATA[<p><a href="https://blog.doismellburning.co.uk/2021-in-books/">As per 2021</a>,
some things I read in 2022 (albeit written up nearly two years later),
along with some brief opinions/recommendations.</p>

<p>All categorisations are approximate at best and will probably cause some kind of contention.</p>

<!-- more -->

<h2 id="fiction">Fiction</h2>

<ul>
  <li><a href="https://amzn.to/3AZJ6gC">Charles Stross’s Quantum of Nightmares</a> - while I don’t think I love the New Management series as much as the early Laundry Files with Bob, I’m still very much enjoying them!</li>
  <li><a href="https://amzn.to/41efK8G">Xiran Jay Zhao’s Iron Widow</a> - very fun</li>
  <li><a href="https://amzn.to/3ZuyEqY">Laura Steven’s The Society for Soulless Girls</a> - saw it on TikTok, really enjoyed it!</li>
  <li><a href="https://amzn.to/4i6yygh">Garon Whited’s Nightlord series (1-3)</a> - while it’s a bit of a power fantasy, I enjoyed it as a “management fantasy” - the protagonist has the time, resources, and trusted competent associates to be able to execute on all of his side projects, and it turns out that I quite enjoy that fantasy(!)</li>
  <li><a href="https://amzn.to/3CJvneq">Tamsyn Muir’s Nona the Ninth</a> - I really enjoyed <a href="https://amzn.to/3ZgFuiu">Gideon</a> and <a href="https://amzn.to/4g5ayYZ">Harrow</a>, but I struggle when characters had multiple names and this is a common theme across the series. Combine that with amnesia/hidden identity subplots, and confusion over whether this is an extended introduction or a book in its own right, and this was easily my least favourite of the three, but I’m still enjoying the series and looking forward to the next</li>
</ul>

<h2 id="non-fiction">Non-Fiction</h2>

<h3 id="work">Work</h3>

<ul>
  <li><a href="https://amzn.to/3ZovJQi">Gerben van den Berg and Paul Pietersma’s Key Management Models: The 75+ Models Every Manager Needs to Know</a> - definitely an interesting reference</li>
</ul>

<h3 id="life">Life</h3>

<ul>
  <li><a href="https://amzn.to/3ZbaAHV">Derek Sivers’s Anything You Want: 40 Lessons for a New Kind of Entrepreneur</a></li>
  <li><a href="https://amzn.to/3OtF5nC">Séamas O’Reilly’s Did Ye Hear Mammy Died?</a> - poignant and funny in equal measures</li>
  <li><a href="https://amzn.to/412M1zJ">Rob Beckett and Josh Widdicombe’s Parenting Hell</a> - a gift from a friend upon my becoming a parent, I enjoyed this more than I expected, and it nicely balanced humour with thoughtfulness</li>
</ul>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[As per 2021, some things I read in 2022 (albeit written up nearly two years later), along with some brief opinions/recommendations. All categorisations are approximate at best and will probably cause some kind of contention.]]></summary></entry><entry><title type="html">2021 In Books</title><link href="https://blog.doismellburning.co.uk/2021-in-books/" rel="alternate" type="text/html" title="2021 In Books" /><published>2024-11-27T00:30:00+00:00</published><updated>2024-11-27T00:30:00+00:00</updated><id>https://blog.doismellburning.co.uk/2021-in-books</id><content type="html" xml:base="https://blog.doismellburning.co.uk/2021-in-books/"><![CDATA[<p><a href="https://blog.doismellburning.co.uk/2020-in-books/">As per 2020</a>,
some things I read in 2021 (albeit written up nearly three years later),
along with some brief opinions/recommendations.</p>

<p>I still wasn’t travelling much in 2021,
which disrupted when/how I usually read,
and this left me in a bit of a reading funk.
But despite the delay I figured I’d catch up,
and I definitely enjoyed looking back!</p>

<p>All categorisations are approximate at best and will probably cause some kind of contention.</p>

<!-- more -->

<h2 id="fiction">Fiction</h2>

<ul>
  <li><a href="https://amzn.to/49cVQx8">Lisa McGee’s Erin’s Diary: An Official Derry Girls Book</a> - I loved <a href="https://en.wikipedia.org/wiki/Derry_Girls">Derry Girls</a> - I didn’t get anywhere near as much out of the book, but it was still fun to read</li>
  <li><a href="https://amzn.to/417SWaK">Amal El-Mohtar and Max Gladstone’s This is How You Lose the Time War</a></li>
  <li><a href="https://amzn.to/4eNz4gu">Steven Hopstaken and Melissa Prusi’s Stoker’s Wilde West</a></li>
  <li><a href="https://amzn.to/4g10hwU">Peter F. Hamilton’s The Confederation Handbook</a> - The Night’s Dawn trilogy was great - I’m not sure I got so much from reading this several years later, but it did remind me that I’d like to revisit the series at some point</li>
  <li><a href="https://amzn.to/4eM8fZT">Yoon Ha Lee’s Phoenix Extravagant</a></li>
  <li><a href="https://amzn.to/4eUDySd">Rosie Claverton’s The Amy Lane Mysteries (1-5)</a> - very fun - boy meets girl, girl is super hacker, they fight crime - I devoured the series</li>
  <li><a href="https://amzn.to/3OrCV81">T. Kingfisher’s A Wizard’s Guide to Defensive Baking</a> - Bob the sourdough - really enjoyable YA fun</li>
  <li><a href="https://amzn.to/3ZaIsVH">Terry Miles’s Rabbits</a></li>
</ul>

<h2 id="non-fiction">Non-Fiction</h2>

<h3 id="life">Life</h3>

<ul>
  <li><a href="https://amzn.to/3Z7TPxp">Derek Sivers’s Hell Yeah or No: What’s Worth Doing</a>, <a href="https://amzn.to/3B8sQty">Your Music and People: creative and considerate fame</a> and <a href="https://amzn.to/4eWWoIM">How to Live: 27 conflicting answers and one weird conclusion</a> - I really enjoy Sivers’s books - short, to the point, but highly thought-provoking</li>
  <li><a href="https://amzn.to/3VagRCS">Eugene Gendlin’s Focusing: How to Gain Direct Access to Your Body’s Knowledge</a> - a little bit “one idea and a lot of talking around it”, but in a good way</li>
  <li><a href="https://amzn.to/4g28wJh">Matthew McConaughey’s Greenlights</a> - I don’t usually go in for (auto)biographies, but my wife recommended it, and it was both fun and insightful</li>
  <li><a href="https://amzn.to/4fMimzb">Chris Wayne’s How I Stopped Being a Fatty (On the Outside)</a> - I worked with Chris at Canonical so picked this up, and it’s a pragmatic and thoughtful - while also funny - tale of his weight-loss journey, with interesting points and considerations</li>
</ul>

<h3 id="work">Work</h3>

<ul>
  <li><a href="https://amzn.to/4g6xmYE">Mike Julian’s Practical Monitoring: Effective Strategies for the Real World</a> - interesting thoughts on monitoring and approaches</li>
  <li><a href="https://amzn.to/3CN57j9">Aviv Ben-Yosef’s The Tech Executive Operating System: Creating an R&amp;D Organization That Moves the Needle</a></li>
  <li><a href="https://amzn.to/4i9WkYC">Sylvia Ann Hewlett’s Executive Presence: The Missing Link Between Merit and Success</a> - great read with many thoughtful points - particularly about the nuances of gender and other considerations</li>
  <li><a href="https://amzn.to/4i9RbzO">Giles Turnbull’s The agile comms handbook</a></li>
  <li><a href="https://amzn.to/4i4H5Ap">Docs for Developers: An Engineer’s Field Guide to Technical Writing</a></li>
</ul>

<h3 id="radio">Radio</h3>

<ul>
  <li><a href="https://amzn.to/3CIXZED">Steve Nichols’s Stealth Antennas</a> - having finally started doing more with <a href="https://radio.doismellburning.co.uk/">amateur radio</a> this was great for some thoughts on getting an antenna up without going for a whole mega mast setup</li>
</ul>

<h3 id="misc">Misc</h3>

<ul>
  <li><a href="https://amzn.to/3CXsmab">Timothy Clifton’s Gravity: A Very Short Introduction</a> - having done a year of undergrad physics, I had the basic idea, but this is a really nice overview and summary</li>
  <li><a href="https://amzn.to/4146ynq">Magic: The Gathering : The Pocket Players’ Guide</a> - I pored over this in the late 90s when I played Magic at school, and it was enjoyable to revisit - interesting stories of how the game first evolved</li>
</ul>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[As per 2020, some things I read in 2021 (albeit written up nearly three years later), along with some brief opinions/recommendations. I still wasn’t travelling much in 2021, which disrupted when/how I usually read, and this left me in a bit of a reading funk. But despite the delay I figured I’d catch up, and I definitely enjoyed looking back! All categorisations are approximate at best and will probably cause some kind of contention.]]></summary></entry><entry><title type="html">There Is No Root Cause</title><link href="https://blog.doismellburning.co.uk/there-is-no-root-cause/" rel="alternate" type="text/html" title="There Is No Root Cause" /><published>2024-10-24T17:14:00+00:00</published><updated>2024-10-24T17:14:00+00:00</updated><id>https://blog.doismellburning.co.uk/there-is-no-root-cause</id><content type="html" xml:base="https://blog.doismellburning.co.uk/there-is-no-root-cause/"><![CDATA[<p>One of my biggest pet peeves, when it comes to incident management and response, is the term “the root cause”.</p>

<p>At best it feels naïve, at worst downright harmful - this notion that there is a singular “root cause” that we can just dig down to, and if we find that, then we’ve cracked it.</p>

<p>Incidents, even the simplest, tend to come from a complex web of context and considerations.</p>

<!-- more -->

<p>There may be a singular triggering event - the one thing that made it all come crashing down - but to call that a “root cause”, like the thinking stops there, is to ignore all the many potential contributing factors, big or small, that made it such a problem.</p>

<p>Consider a hypothetical warehouse fire. Maybe the triggering event was a discarded cigarette by the back door. But maybe a great many factors contributed to that ending up as a raging inferno rather than just some minor littering:</p>

<ul>
  <li>Maybe it’s a common nighttime hangout spot for local teenagers to smoke - forced out of other places by poor urban planning. So rather than a secure and clear area, there’s people, there’s litter, all in a place not really designed for it.</li>
  <li>Maybe the firefighters took longer to turn up than ideal - maybe because budget cuts, or poor rota design, or a local traffic issue</li>
  <li>Maybe your warehouse inventory was stored in such a way that flammables were kept along the back wall, instead of more centrally where they were more isolated. Maybe this was a systematic failure of your storage system, maybe this was just a temporary situation because of recent growth in your organisation.</li>
</ul>

<p>Yes, look hard at that discarded cigarette - without it you might not be looking at a financial and logistical nightmare. But to call it a “root cause”, like it all stops there, like the whole situation doesn’t emerge from a complex web of factors, some situational but some systematic, some within your control but some totally beyond - that feels like unhelpfully short-sighted thinking.</p>

<p>Incidents are learning opportunities.
If you stop your exploration at some “root cause”, you risk throwing away lots of potential value.
Inevitably there will be opportunities to improve across the board.
They might not always be worth actively doing anything about, but they are still usually worth recording.</p>

<h2 id="what-instead">What Instead?</h2>

<p>Stop looking for a “root cause”, start looking at:</p>

<ol>
  <li>The Triggering Event - what happened to make things go “bang”?</li>
  <li>As many Contributing Factors as you can - what made things worse than they could have been?</li>
</ol>

<p>I generally find that the Triggering Event is, though worth noting, often the least interesting part.
A component failed, a mistake was made, whatever.
Components fail, people make mistakes - and a healthy system should cope.
But you’re probably doing this exercise because it didn’t.
It’s worth knowing that a discarded cigarette started the fire,
but could you have necessarily done much about it,
and could any one of a number of similar things led to the same outcome?</p>

<p>The Contributing Factors are where I find all the really interesting things turn up.
There’s often a point of diminishing returns,
but sometimes even small-seeming things can be valuable to think about.
Maybe the fire was made worse by flammable material being temporarily stored nearby as a result of lack of space due to recent growth - in isolation seemingly simple misfortune, but potentially part of a pattern of issues forcing a rethink of the growth strategy, or at least a cost worth considering.</p>

<p>You may look at a Contributing Factor and decide it’s not a priority to address, and that’s fine!
But it’s still valuable to record it, and consider mitigations and/or improvements.</p>

<h2 id="see-also">See also</h2>

<ul>
  <li><a href="https://github.com/readme/guides/root-cause">GitHub’s ReadME project on “What we talk about when we talk about ‘root cause’”</a></li>
  <li><a href="https://www.kitchensoap.com/2012/02/10/each-necessary-but-only-jointly-sufficient/">John Allspaw’s “Each necessary, but only jointly sufficient”</a></li>
  <li><a href="https://codywilbourn.com/2018/01/02/root-cause-is-plural/">Cody Wilbourn’s “Root Cause is Plural”</a></li>
</ul>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[One of my biggest pet peeves, when it comes to incident management and response, is the term “the root cause”. At best it feels naïve, at worst downright harmful - this notion that there is a singular “root cause” that we can just dig down to, and if we find that, then we’ve cracked it. Incidents, even the simplest, tend to come from a complex web of context and considerations.]]></summary></entry><entry><title type="html">USB-C: A Rant</title><link href="https://blog.doismellburning.co.uk/usb-c-a-rant/" rel="alternate" type="text/html" title="USB-C: A Rant" /><published>2024-06-16T17:00:00+00:00</published><updated>2024-06-16T17:00:00+00:00</updated><id>https://blog.doismellburning.co.uk/usb-c-a-rant</id><content type="html" xml:base="https://blog.doismellburning.co.uk/usb-c-a-rant/"><![CDATA[<p>(Disclaimer: This is a minimally-edited version of a midnight rant on Discord.
Do not expect a particularly nuanced take,
this does not reflect my usual level of compassion and empathy,
I’m sure the standards authors are smart and wonderful people and I benefit from their work etc.)</p>

<p>I’m sure the spec authors are smart and reasonable upstanding people who believe they are making the world a better place but with all due respect USB-C can absolutely get in the sea.
Or at least I wish some very stubbed toes upon people.</p>

<p>There was a brief shining period in my life when USB felt good.
I felt like I understood it, I felt like I could trust it. It was simple.</p>

<!-- more -->

<p>There was a version number, that basically meant “speed”:
1 was “slow as heck”, 2 was “decent” and 3 was “turbo”.
There was a letter for the connector:
A was for hosts and basically came in maxi only (if you’ve ever seen mini or micro A in real life please let me know),
and B was for devices and came in maxi/mini/micro and was really the only end worth mentioning.
And that was basically it?
And things just worked?
And sure, there were quirks like you’d need to try three times to plug something in,
but you knew where you stood.
Things were simple but effective - if you could plug it in,
999 times out of 1000 things would Just Work.</p>

<p>And then along comes USB-C,
which isn’t so much a standard as 14159265 different standards and options all stood on one another’s shoulders under a big-ass trenchcoat.
Does C refer to the standard or the connector or something else?
I sure don’t know.
(Edit: I’m wrong, USB-C refers to the connector, it’s probably more accurate to say my frustrations are with some new version of the USB standard, but I still don’t fully understand what and which, and I’m not alone here!)</p>

<p>Sure, there’s only one connector type now,
and orientation doesn’t matter
(mechanically at least; I’ll get to that nuance later).
But other than that, my life as a user has gotten materially more frustrating.</p>

<p>Because now everything is Smart, or needs to be.
You can put Ethernet down it or HDMI down it,
except maybe you can’t if one of the devices at the other end or the cable itself disagrees.
How do you know if the cable will work?
Good bloody question.
Devices might negotiate power except they might not and maybe you’ll plug something in to charge and it just won’t and haha sucks to be you.
(Edit: <a href="https://sa.lj.am/usbccccc/">In 2021 there were apparently 8 kinds of USB-C to USB-C cable, all visually indistinct</a>)</p>

<p>And the plugs have computers.
And I sometimes feel like I have enough computers in my life already without my cables being two computers too.
Because now my plugs can be running different versions of firmware,
or maybe they’re running something malicious and haha as if I’ve got any chance of figuring that out.
(Edit: <a href="https://x.com/whitequark/status/1035768269096071168">See whitequark on this and many other bits of USB bonkers up- and down-thread</a>)</p>

<p><a href="https://en.wikipedia.org/wiki/BadUSB">There was a time when “my cable has a tiny computer in it” was how you identified the Bad USB Cables because it meant someone was doing Naughty Things and you could smash the cable and be free</a>.
But now your cables don’t do the right things if the tiny computers disagree and haha good luck.</p>

<p>And has anyone developed a standard for clearly identifying or labelling what a cable might decide to do?
Have they bollocks.
(Edit: <a href="https://sa.lj.am/usbccccc/">There is now a proposal, but good luck figuring out what you actually have</a>)</p>

<p>So now I have half a face of stubble because my beard trimmer “charges with USB-C”
except I have a USB-C charger here and when I plug it in then precisely nothing happens,
which I can only assume is because the charger is expecting it to negotiate power and the beard trimmer is negotiating precisely sod all because it’s a beard trimmer and consists of a battery and a motor and a blade.</p>

<p>I’m going to go wax my face or something.</p>

<hr />

<p>Update: <a href="https://learn.adafruit.com/understanding-usb-type-c-cable-types-pitfalls-and-more/cable-types-and-differences">Adafruit have a (genuinely) helpful guide about USB-C cable types and differences</a>.
However it includes this gem:</p>

<blockquote>
  <p>Always double check a cable’s capabilities before using to power laptops or monitors</p>
</blockquote>

<p>I appreciate that the message is effectively a disclaimer, and made with good intent.
<a href="https://howfuckedismydatabase.com/nosql/">However it feels akin to being told to write a distributed map reduce function in Erlang in order to query a database - not entirely the most practical of advice…</a></p>

<p>I think it’s fair to say I’m somewhat technically competent,
like, I own USB debug hardware and I even have a rough idea of how to use it.
But I have <em>no</em> idea how to “check a USB-C cable’s capabilities” beyond <a href="https://en.wikipedia.org/wiki/Benson_Leung">offering up a prayer to Benson</a>.
I imagine the average layperson doesn’t even realise different cables <em>exist</em>…!</p>

<hr />

<p>Update:
In attempting to learn which version of USB to hold responsible,
I turned to <a href="https://en.wikipedia.org/w/index.php?title=USB-C&amp;oldid=1224452941">the Wikipedia article on USB-C</a>
whereupon I learned that:</p>

<blockquote>
  <p>A device with a Type-C connector does not necessarily implement any USB transfer protocol, USB Power Delivery, or any of the Alternate Modes: the Type-C connector is common to several technologies while mandating only a few of them.</p>
</blockquote>

<p>Good luck.</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[(Disclaimer: This is a minimally-edited version of a midnight rant on Discord. Do not expect a particularly nuanced take, this does not reflect my usual level of compassion and empathy, I’m sure the standards authors are smart and wonderful people and I benefit from their work etc.) I’m sure the spec authors are smart and reasonable upstanding people who believe they are making the world a better place but with all due respect USB-C can absolutely get in the sea. Or at least I wish some very stubbed toes upon people. There was a brief shining period in my life when USB felt good. I felt like I understood it, I felt like I could trust it. It was simple.]]></summary></entry><entry><title type="html">Why Us? A Favourite Interview Question</title><link href="https://blog.doismellburning.co.uk/why-us-a-favourite-interview-question/" rel="alternate" type="text/html" title="Why Us? A Favourite Interview Question" /><published>2023-12-27T09:19:55+00:00</published><updated>2023-12-27T09:19:55+00:00</updated><id>https://blog.doismellburning.co.uk/why-us-a-favourite-interview-question</id><content type="html" xml:base="https://blog.doismellburning.co.uk/why-us-a-favourite-interview-question/"><![CDATA[<p>One of my favourite questions to ask in an initial job interview/screening is this:</p>

<blockquote>
  <p>What attracted you to the role with us?</p>
</blockquote>

<p>Plus the <em>absolutely vital</em> follow-up:</p>

<blockquote>
  <p>(“I want a new job and yours didn’t sound completely awful” is an <em>entirely</em> reasonable answer!)</p>
</blockquote>

<p>That second part is key.</p>

<!-- more -->

<p>On its own, the question risks seeming like an uninteresting request for praise - “tell us how awesome we are!”— <a href="https://theoatmeal.com/comics/interview_questions">as The Oatmeal has so graphically illustrated in “The Six Crappiest Interview Questions”</a>.</p>

<p>But it’s a question that can have significant value, especially when asked early on.</p>

<p>Sometimes there’s a huge expectation mismatch - whatever the candidate is looking for is not something they’re going to get from us - and the sooner that’s discovered and discussed, the better for everyone.</p>

<p>Sometimes (though rarely) people can actually “fail” the question. I am absolutely 100% open to hiring people who, at this stage, have nothing more than “this kinda looks interesting, let’s talk more” - it’s a two-way process after all - but if someone’s only response is to pour abuse on their current co-workers and workplace, then perhaps they don’t have the perspective and the thoughtfulness that I’m looking for.</p>

<p>Even if I don’t get much useful information about the candidate, I get feedback on our advert and how we’re perceived.</p>

<p>Finally, there’s a signalling aspect with the flippant second half.
I try to run an inclusive thoughtful hiring process that reflects what we actually value.
I don’t want people standing on ceremony,
I don’t want arbitrary hoop jumping.
The more open and honest I can encourage candidates to be, the better.</p>

<p>Try it, see what responses you get!</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[One of my favourite questions to ask in an initial job interview/screening is this: What attracted you to the role with us? Plus the absolutely vital follow-up: (“I want a new job and yours didn’t sound completely awful” is an entirely reasonable answer!) That second part is key.]]></summary></entry><entry><title type="html">How I Read</title><link href="https://blog.doismellburning.co.uk/how-i-read/" rel="alternate" type="text/html" title="How I Read" /><published>2023-12-26T22:02:23+00:00</published><updated>2023-12-26T22:02:23+00:00</updated><id>https://blog.doismellburning.co.uk/how-i-read</id><content type="html" xml:base="https://blog.doismellburning.co.uk/how-i-read/"><![CDATA[<p>I love reading. When I was younger this was a bit of a problem - my parents had to move my dad’s Stephen King horror books because I’d start reading them as soon as I’d grown tall enough to reach the shelf - or the time I asked “mummy what’s a murder” because I would read old newspapers left around for recycling.</p>

<p>But I’ve found so much joy through reading - and even though today for various reasons I don’t read as much as I used to, it’s still one of the best ways for me to pick up information.</p>

<p>I read quickly (e.g. Lord of the Rings in about a week at around 10 years old). This is almost certainly a huge factor in my enjoyment. I don’t know how exactly I do this or where learned this; I think I taught myself at a fairly young age. But an indirect benefit, other than the obvious speed itself, is that it makes it very low cost to try out a book/series - it doesn’t take me much time or effort to get through enough to decide if I want to continue!</p>

<!-- more -->

<h2 id="media">Media</h2>

<p>When it comes to books, I want Kindle for fiction, paper for non-fiction.</p>

<p>I consume fiction linearly. My Kindle is great for reading linearly. (Books like The Silmarillion, where I need to constantly flick back and forth to the character list to understand who someone is and which of their twelve names they might be using, do not spark joy)</p>

<p>My Kindle lets me carry a whole bunch of books for very little space and very little weight. The battery life is great, and the next book is just a download away - no need to try to decide if it’s worth lugging an additional paperback around in case I finish the one I’m on.</p>

<p>Non-fiction, I want a more interactive experience. I want to bookmark pages to quickly flick to, I want to flip between sections, I want to highlight, annotate, and more. These are all <em>possible</em> with the Kindle, but far easier with actual paper.</p>

<p>Audiobooks don’t work for me at all. They sound like a wonderful experience for so many other people, I’m a little jealous, but they’re not for me. I probably have some mild auditory processing challenges that are a factor here. (But people who look down on audiobooks with the claim “you’ve not really read the book” can get in the sea with their gatekeeping)</p>

<p>Articles, blog posts etc., usually on my phone or desktop. I was a happy Google Reader customer until they killed it, now I’m a happy Feedbin customer. That said, I hit feed burnout a few years ago and haven’t quite gotten over it, so mostly I get links from friends and newsletters and social media.</p>

<p>I’m continually frustrated with the modern trend of sharing things only through video. I appreciate there’s lots of incentives for people to do so - improved reach, harder to copy, popularity etc. - but personally I hate it. Fortunately, it seems like AI is getting to the point where it’s cheap and easy for me to make a transcript and just read that. Unfortunately sometimes that isn’t enough, and while I completely understand e.g. Minecraft builders using video to share details of their creations, gosh I wish they’d publish more schematics…!</p>

<h2 id="where">Where</h2>

<p>My favourite time and place to read has been while travelling.</p>

<p>As a child, holidays would often involve a fair amount of time in the back of a car. As an only child, books were an excellent source of entertainment, and unlike my GameBoy, they wouldn’t run out of battery!</p>

<p>As an adult commuting into London or flying to Germany for work, the silver lining was the fantastic chunk of time for reading.</p>

<p>But between the pandemic causing me to travel a lot less, and parenthood meaning I’m often driving when I do, I’m reading substantially less.</p>

<h2 id="so">So</h2>

<p>I’m not advocating for anything here - this is what works for me, you do you.</p>

<p>But if you want me to take information onboard, the best way is to write it down!</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[I love reading. When I was younger this was a bit of a problem - my parents had to move my dad’s Stephen King horror books because I’d start reading them as soon as I’d grown tall enough to reach the shelf - or the time I asked “mummy what’s a murder” because I would read old newspapers left around for recycling. But I’ve found so much joy through reading - and even though today for various reasons I don’t read as much as I used to, it’s still one of the best ways for me to pick up information. I read quickly (e.g. Lord of the Rings in about a week at around 10 years old). This is almost certainly a huge factor in my enjoyment. I don’t know how exactly I do this or where learned this; I think I taught myself at a fairly young age. But an indirect benefit, other than the obvious speed itself, is that it makes it very low cost to try out a book/series - it doesn’t take me much time or effort to get through enough to decide if I want to continue!]]></summary></entry><entry><title type="html">My Python GitHub Template</title><link href="https://blog.doismellburning.co.uk/my-python-github-template/" rel="alternate" type="text/html" title="My Python GitHub Template" /><published>2023-11-19T17:52:01+00:00</published><updated>2023-11-19T17:52:01+00:00</updated><id>https://blog.doismellburning.co.uk/my-python-github-template</id><content type="html" xml:base="https://blog.doismellburning.co.uk/my-python-github-template/"><![CDATA[<p>I really love “development tooling”; there’s so many things - from static analysers to formatters to test infrastructure and more - that help me catch problems and potential issues early.
I use enough tooling, and create just enough Python projects, to want a convenient reference and starting point.</p>

<p>So I’ve set up a <a href="https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository">GitHub template repository</a> at <a href="https://github.com/doismellburning/python-template/">https://github.com/doismellburning/python-template/</a></p>

<p>Features include:</p>

<!-- more -->

<ul>
  <li><a href="https://pipenv.pypa.io/en/latest/">Pipenv</a> for dependency management</li>
  <li>Dependabot updates for Python dependencies and GitHub Actions</li>
  <li>Dependabot auto-merge for minor and patch-level updates</li>
  <li>Makefile with convenience commands</li>
  <li><a href="https://black.readthedocs.io/en/stable/">Black</a> for code formatting</li>
  <li><a href="https://www.structlog.org/en/stable/">structlog</a> for structured logging (thanks <a href="https://hynek.me/">Hynek</a>!)</li>
  <li><a href="https://docs.pytest.org/en/stable/">pytest</a> for testing</li>
  <li><a href="https://coverage.readthedocs.io/en/latest/">Coverage.py</a> and <a href="https://github.com/pytest-dev/pytest-cov">pytest-cov</a> for measuring code coverage</li>
  <li><a href="https://www.mypy-lang.org/">Mypy</a> for type checking</li>
  <li><a href="https://docs.astral.sh/ruff/">Ruff</a> for <a href="https://docs.astral.sh/ruff/rules/">linting ALL the things</a> (thanks <a href="https://ghickman.co.uk/">George</a> for the recommendation)</li>
</ul>

<p>You almost certainly don’t want to use this yourself - it’s highly opinionated and tailored to me. But it may be an interesting reference - it’s already been a useful place to grab bits from for other ongoing projects I have!</p>]]></content><author><name>Kristian Glass</name></author><summary type="html"><![CDATA[I really love “development tooling”; there’s so many things - from static analysers to formatters to test infrastructure and more - that help me catch problems and potential issues early. I use enough tooling, and create just enough Python projects, to want a convenient reference and starting point. So I’ve set up a GitHub template repository at https://github.com/doismellburning/python-template/ Features include:]]></summary></entry></feed>