<?xml version="1.0" encoding="utf-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/"><channel><title>Jeff Bailey</title><link>https://jeffbailey.us/</link><description>This website contains learning resources, opinions, and facts about software-related technology.</description><language>en</language><generator>Hugo</generator><atom:link href="https://jeffbailey.us/rss.xml" rel="self" type="application/rss+xml"/><lastBuildDate>Sat, 07 Nov 2026 00:00:00 +0000</lastBuildDate><item><title>What Is Markdown?</title><link>https://jeffbailey.us/blog/2026/11/07/what-is-markdown/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/11/07/what-is-markdown/</guid><pubDate>Sat, 07 Nov 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>What X</category><category>Writing</category><category>Web Development</category><description><![CDATA[<p>Type <code>**done**</code> in a GitHub comment, and it appears as <strong>done</strong>. Add <code>#</code> to a README line, and it becomes a heading. Paste the same text elsewhere, and a table may collapse into pipes and dashes. These moments share one idea; understanding it makes them feel predictable.</p>
<p>Markdown is plain text that programs convert into HTML (HyperText Markup Language), which browsers display. This article explains why Markdown exists, how renderers process it, why its meaning varies by context, and when it’s unsuitable.</p>]]></description></item><item><title>Learn Retrieval Augmented Generation: Build the Simplest RAG in SQLite</title><link>https://jeffbailey.us/blog/2026/11/05/learn-retrieval-augmented-generation/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/11/05/learn-retrieval-augmented-generation/</guid><pubDate>Thu, 05 Nov 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>AI Engineering</category><category>Databases</category><category>Practice</category><description><![CDATA[<p><strong>Quick Start:</strong> Build a working RAG pipeline with ten documentation chunks, one SQLite table, and two queries in about 30 minutes. It runs locally without a vector database, embedding model, or API key. Then send the prompt to your chosen chat assistant, hosted model, or local Ollama model. To test the queries first, visit <a href="#practice-rag">Practice RAG</a>, which runs real SQLite in your browser.</p>
<p>You ask your AI assistant how to roll back a deploy. It confidently suggests <code>git revert</code> and <code>kubectl rollout undo</code>, but your team does neither. The real answer is in <code>runbook/deploy.md</code>, which the model hasn’t seen. It also warns not to touch migrations, a critical detail the generic answer misses.</p>]]></description></item><item><title>What Is InnerSource?</title><link>https://jeffbailey.us/blog/2026/10/31/what-is-innersource/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/31/what-is-innersource/</guid><pubDate>Sat, 31 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>What X</category><category>InnerSource</category><category>Open Source</category><description><![CDATA[<p>Picture a company where five teams have each built their own logging library. Nobody knew the other four existed, so each team spent weeks solving problems a neighbor had solved months earlier. The company now pays to maintain all five.</p>
<p>InnerSource is a practice built to stop this from happening. It takes the way open source projects collaborate and applies it to the code inside your company: readable code, pull requests from outsiders, and maintainers who review and mentor. By the end of this article, you&rsquo;ll understand where InnerSource came from and the problem it solves. You&rsquo;ll also know the roles and principles that make it work, and where it falls short.</p>]]></description></item><item><title>Fundamentals of InnerSource</title><link>https://jeffbailey.us/blog/2026/10/31/fundamentals-of-innersource/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/31/fundamentals-of-innersource/</guid><pubDate>Sat, 31 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Fundamentals</category><category>Software Engineering</category><category>Leadership</category><description><![CDATA[<h2 id="introduction">Introduction</h2>
<p>Your team needs one small change to another team&rsquo;s library. You file a feature request. It lands in their backlog behind six months of their own priorities. So you fork the library, patch it, and move on.</p>
<p>A year later the organization runs two copies of the same code, each with its own bugs, and nobody remembers why.</p>
<p>I&rsquo;ve worked in organizations where five teams built five versions of the same logging library. Nobody knew the other versions existed. Each team spent weeks solving problems that another team had solved months earlier. That waste is invisible on any budget line, which is exactly why it keeps happening.</p>]]></description></item><item><title>Learn SQL: Queries, Joins, Aggregates, and Query Plans</title><link>https://jeffbailey.us/blog/2026/10/22/learn-sql/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/22/learn-sql/</guid><pubDate>Thu, 22 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Databases</category><category>Data Engineering</category><category>Practice</category><description><![CDATA[<p><strong>Quick Start:</strong> Build a two-table database with <code>sqlite3</code>, then filter, join, group, and rank its rows. The hands-on work takes about 30 minutes, with no server to install. To try the queries first, use the <a href="#practice-sql">Practice SQL</a> section, which runs them in your browser.</p>
<p>SQL looks like English, which is why it fools people. <code>SELECT name FROM customers WHERE city = NULL</code> reads fine and returns nothing. A <code>LEFT JOIN</code> with one extra condition in the <code>WHERE</code> clause drops the customers you meant to keep, with no error. A report that took two seconds last spring takes two minutes now, and nothing in the query text tells you why.</p>]]></description></item><item><title>Learn Agile: Core Practices and Hard Truths for Agilists</title><link>https://jeffbailey.us/blog/2026/10/17/learn-agile/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/17/learn-agile/</guid><pubDate>Sat, 17 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Software Engineering</category><category>Leadership</category><category>Learn X</category><category>Practice</category><description><![CDATA[<p>You have joined an agile team as a Scrum Master, coach, or team lead. Start by learning the team&rsquo;s context, then earn enough trust to run one small experiment.</p>
<h2 id="what-youll-learn">What You&rsquo;ll Learn</h2>
<ul>
<li>What is agile, and what problem does it solve?</li>
<li>Where does agile fit, and where does it fit poorly?</li>
<li>Which few practices give you most of the value?</li>
<li>Why do capable Scrum Masters and coaches fail, and how can you avoid it?</li>
<li>What should you do in your first weeks in an agile role?</li>
<li>Where can you go to learn more about agile?</li>
</ul>
<h2 id="the-basics">The Basics</h2>
<p>Agile uses values and principles to build software in small, frequent working pieces, adapting processes as work progresses.</p>]]></description></item><item><title>Learn Platform Engineering: Golden Paths, Platform as a Product, and Team Topologies</title><link>https://jeffbailey.us/blog/2026/10/15/learn-platform-engineering/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/15/learn-platform-engineering/</guid><pubDate>Thu, 15 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software Engineering</category><category>DevOps</category><description><![CDATA[<p>Last quarter, your company launched an internal platform with a portal, pipeline builder, and kickoff deck featuring &ldquo;revolutionize all the things&rdquo;. Six months later, developers still ask colleagues for databases, share Terraform scripts, and manually paste secrets. Everyone’s busy, but progress is slower than expected.</p>
<p>This guide covers the 20% of platform engineering that drives 80% of the work: build around engineers’ actual needs, keep the platform thin, and let teams choose it. You&rsquo;ll create a ranked backlog from five interviews and a shadowed deploy, a one-page team charter, a documented golden path, a three-bin governance sort, and a request-to-fulfillment metric. You&rsquo;ll also assess what AI coding assistants build without guidance.</p>]]></description></item><item><title>SPDX vs CycloneDX: Which SBOM Standard to Use</title><link>https://jeffbailey.us/blog/2026/10/13/spdx-vs-cyclonedx/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/13/spdx-vs-cyclonedx/</guid><pubDate>Tue, 13 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>X vs X</category><category>Software Supply Chain</category><category>Security</category><category>Compliance</category><description>&lt;p>A customer, an auditor, or a procurement form asks for a Software Bill of Materials (SBOM), and the first question is which format. Two standards cover most requests: SPDX and CycloneDX. Both list the components in your software, both are free, and common generators like Syft and Trivy write both, so the choice can seem arbitrary.&lt;/p>
&lt;p>It stops being arbitrary once you know who reads the file. A license compliance team, a vulnerability triage pipeline, and a German government buyer want different things, and each format serves some of those readers better than the other.&lt;/p></description></item><item><title>Learn AWS Lambda: Handlers, Cold Starts, and the AWS CLI</title><link>https://jeffbailey.us/blog/2026/10/13/learn-aws-lambda/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/13/learn-aws-lambda/</guid><pubDate>Tue, 13 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Cloud</category><category>Software Engineering</category><description><![CDATA[<p><strong>Quick Start:</strong> Create, invoke, and delete a Python function with the AWS CLI, or run the same commands in the practice shell without an account. Hands-on work takes about 20 minutes; the rest covers what determines Lambda&rsquo;s production behavior.</p>
<p>Lambda functions seem easy to ship: one function, no servers, millisecond billing. Then a queue delivers a message twice, an unset timeout kills a request after three seconds, and the next call takes a second longer. These surprises stem from a few core concepts this guide covers.</p>]]></description></item><item><title>What Is Graph Engineering?</title><link>https://jeffbailey.us/blog/2026/10/08/what-is-graph-engineering/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/08/what-is-graph-engineering/</guid><pubDate>Thu, 08 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>What X</category><category>AI Engineering</category><category>Software Architecture</category><description>&lt;p>Ask a language model for an essay in one prompt, and it writes from the first word to the last without a backspace key. Andrew Ng uses that image to explain why single prompts top out. The fix everyone reaches for next is a loop: let the model call a tool, look at the result, and go again. That works for a demo. Then someone asks you to pause it for approval, resume it after a crash, or explain why it searched the same thing nine times, and a plain loop gives you nowhere to hook any of that in.&lt;/p></description></item><item><title>Learn fd: Find Files Fast with Patterns, Filters, and -x</title><link>https://jeffbailey.us/blog/2026/10/08/learn-fd/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/08/learn-fd/</guid><pubDate>Thu, 08 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software Engineering</category><category>Practice</category><description><![CDATA[<p>You keep a line like <code>find . -name '*.py' -not -path './node_modules/*'</code> in a notes file because you never remember its order, and you still get <code>node_modules</code> noise when you forget the <code>-not -path</code> part. fd is a small program that finds files by name with a shorter command, skips what your <code>.gitignore</code> already ignores, and runs a command on every result.</p>
<p>This guide covers the 20% of fd that does 80% of the work: matching names with plain text, regular expressions, and globs; filtering by extension, type, depth, and size; ignore rules and hidden files; and running commands with <code>-x</code> and <code>-X</code>. A searchable command reference and a set of videos, books, and online resources close the article.</p>]]></description></item><item><title>Learn Zsh: Globbing, Expansion, Completion, History, and a Command Reference</title><link>https://jeffbailey.us/blog/2026/10/06/learn-zsh/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/06/learn-zsh/</guid><pubDate>Tue, 06 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software Engineering</category><category>Practice</category><description><![CDATA[<p>Your Mac switched you from bash to zsh, and your <code>~/.zshrc</code> is a few hundred lines pasted from a framework install. Lines such as <code>setopt</code>, <code>bindkey</code>, and <code>zstyle</code> look opaque, and <code>*(om[1])</code> looks like line noise. This guide shows what stock zsh does on its own, with no plugins, so you can read your own config and decide what belongs in it.</p>
<p>It covers the 20% of zsh that does 80% of the work: globbing and glob qualifiers, parameter expansion and arrays, completion, history expansion, options, key bindings, and <code>~/.zshrc</code>. A searchable command reference and a curated set of videos, podcasts, books, and online resources close the article.</p>]]></description></item><item><title>Learn Nushell: Tables, Pipelines, Data Files, and a Command Reference</title><link>https://jeffbailey.us/blog/2026/10/03/learn-nushell/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/03/learn-nushell/</guid><pubDate>Sat, 03 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software Engineering</category><category>Practice</category><description><![CDATA[<p>You pipe JSON from an API into <code>grep</code>, then <code>cut</code>, then <code>awk</code>, and the script breaks the day a field moves. Nushell skips the text parsing. Every command hands the next one a table, a list, or a record, so you filter and sort by column name instead of by character position.</p>
<p>This guide covers the 20% of Nushell that does 80% of the work: tables and pipelines, opening data files, records and lists, finding help, variables, custom commands with <code>def</code>, and your configuration file. A searchable command reference and a curated set of videos, podcasts, books, and online resources close the article.</p>]]></description></item><item><title>What Are AI Evals?</title><link>https://jeffbailey.us/blog/2026/10/01/what-are-ai-evals/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/10/01/what-are-ai-evals/</guid><pubDate>Thu, 01 Oct 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>What X</category><category>AI</category><category>Software</category><description><![CDATA[<p>You tweak a prompt, test three questions, and get better answers. A week after shipping it, a customer reports the bot now invents refund policies. No one checked the forty other question types the old prompt handled.</p>
<p>AI evals fill this gap. By the end, you&rsquo;ll know what they measure, why ordinary tests fall short for language model features, and how eval scores can mislead.</p>
<h2 id="what-is-an-ai-eval">What Is an AI Eval?</h2>
<p>An AI eval (short for evaluation) is a repeatable test of how well an AI system performs a specific task. It runs fixed inputs through the system, grades each output against criteria written in advance, and produces a score you can track over time.</p>]]></description></item><item><title>Learn Tmux: Sessions, Windows, Panes, and a Command Reference</title><link>https://jeffbailey.us/blog/2026/09/27/learn-tmux/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/27/learn-tmux/</guid><pubDate>Sun, 27 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software Engineering</category><category>Practice</category><description><![CDATA[<p>Wi-Fi drops during an SSH deploy, killing your shell, or six terminal tabs leave you unsure which runs the dev server. tmux keeps shells running, splits one terminal into many, and lets you return right where you left off.</p>
<p>This guide covers essential tmux basics—sessions, windows, panes, the prefix key, and a simple config—plus a searchable command reference and curated videos, podcasts, books, and online resources.</p>
<h2 id="what-youll-learn">What You&rsquo;ll Learn</h2>
<ul>
<li>When to use tmux versus terminal tabs.</li>
<li>How sessions, windows, and panes fit.</li>
<li>How the prefix key works and makes every reference binding clear.</li>
<li>Configure tmux with <code>.tmux.conf</code>.</li>
<li>Add plugins and keep remote work running over SSH.</li>
</ul>
<h2 id="when-to-use-tmux">When to Use Tmux</h2>
<p>tmux runs your shells in a background server, while terminal windows act as clients. Shells keep running after you close a window, lose your network, or log out, until you reattach.</p>]]></description></item><item><title>jq Cheat Sheet: Filters, Operators, and Output Formats</title><link>https://jeffbailey.us/blog/2026/09/25/jq-cheat-sheet/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/25/jq-cheat-sheet/</guid><pubDate>Fri, 25 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Reference</category><category>Command Line</category><category>Developer Tools</category><description><![CDATA[<p>Every entry below is a jq filter, what it returns, and a minimal example. Output shown came from jq 1.8.2.</p>
<p>For the guided version with explanations and larger worked examples, read the <a href="https://jeffbailey.us/blog/2021/11/30/learn-jq/">jq Cookbook</a>.</p>
<h2 id="run-any-entry-here">Run Any Entry Here</h2>
<p>The playground runs real jq 1.8.2 on the same <code>employees.json</code> used throughout this reference. Paste any filter or <code>jq</code> command from the entries below into the command line and press Run.</p>

<script>document.documentElement.classList.add('playground-js');</script>

<div class="jqwp" data-jq-playground data-playground="jq" data-jqwp-version="4c1bc3ce7ce9f1bd670cd3d74b131d2d" data-jqwp-shared-version="3f3114c8664b6183629e8e92db3ef7bc">
  <p class="jqwp-status" role="status" aria-live="polite">Practice the commands on this page in real jq, right here. Nothing downloads until Start (about 360 KB).</p>]]></description></item><item><title>Fix: Too Many Authentication Failures</title><link>https://jeffbailey.us/blog/2026/09/21/ssh-too-many-authentication-failures/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/21/ssh-too-many-authentication-failures/</guid><pubDate>Mon, 21 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Security</category><category>System Administration</category><category>Command Line</category><category>Troubleshooting</category><description><![CDATA[<p>SSH disconnects before you can type a password:</p>
<pre><code class="language-text">Received disconnect from 203.0.113.10 port 22:2: Too many authentication failures
Disconnected from 203.0.113.10 port 22</code></pre><p>You have the right key. The server never got to it. SSH offers every identity it can find, in order, and the server counts each one as a failed attempt. Its default limit is six.</p>
<p>Everything below was reproduced against OpenSSH 10.3 on both ends, with a server left at the default <code>MaxAuthTries</code>.</p>]]></description></item><item><title>Fix: Support for Password Authentication Was Removed</title><link>https://jeffbailey.us/blog/2026/09/21/git-password-authentication-removed/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/21/git-password-authentication-removed/</guid><pubDate>Mon, 21 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Git</category><category>Security</category><category>Command Line</category><category>Troubleshooting</category><description><![CDATA[<p>Your password works when you sign in to github.com, and Git rejects it:</p>
<pre><code class="language-text">remote: Support for password authentication was removed on August 13, 2021.
remote: Please see https://docs.github.com/get-started/getting-started-with-git/about-remote-repositories#cloning-with-https-urls for information on currently recommended modes of authentication.
fatal: Authentication failed for &#39;https://github.com/you/your-repo.git/&#39;</code></pre><p>GitHub has since shortened the message. Running the same thing today gives this instead, tested with Git 2.55.0:</p>
<pre><code class="language-text">remote: Invalid username or token. Password authentication is not supported for Git operations.
fatal: Authentication failed for &#39;https://github.com/you/your-repo.git/&#39;</code></pre><p>Both mean one thing: the account password is not a Git credential and has not been since 13 August 2021. You need either an SSH key or a personal access token. Nothing is wrong with your account.</p>]]></description></item><item><title>Fix: ssh: connect to host github.com port 22: Connection timed out</title><link>https://jeffbailey.us/blog/2026/09/21/ssh-connect-to-host-github-port-22/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/21/ssh-connect-to-host-github-port-22/</guid><pubDate>Mon, 21 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Git</category><category>Networking</category><category>Command Line</category><category>Troubleshooting</category><description><![CDATA[<p>Git hangs for a while, then gives up:</p>
<pre><code class="language-text">ssh: connect to host github.com port 22: Connection timed out
fatal: Could not read from remote repository.</code></pre><p>Your key is not the problem. The connection never got far enough to offer one. Something between you and GitHub is dropping traffic on port 22, which is normal on corporate networks, many hotel and airport networks, and some mobile hotspots.</p>
<p>GitHub publishes an SSH endpoint on port 443 for exactly this. Everything below was tested with OpenSSH 10.3 and Git 2.55.0.</p>]]></description></item><item><title>Structurizr vs Mermaid vs PlantUML for C4 Diagrams</title><link>https://jeffbailey.us/blog/2026/09/20/structurizr-vs-mermaid-vs-plantuml/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/20/structurizr-vs-mermaid-vs-plantuml/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>X vs X</category><category>Software Architecture</category><category>Developer Tools</category><description><![CDATA[<p>Three tools draw <a href="https://c4model.com/">C4 diagrams</a> from text, and picking between them looks like a taste question about syntax. It is mostly a question about what you want to keep: a picture, or a model that can produce pictures.</p>
<p>Everything below was run on one system modeled three ways, with Structurizr 2026.09.19 (structurizr-* 6.2.3), Mermaid CLI 11.17.0 on mermaid 11.17.2, and PlantUML 1.2026.8 on Graphviz 16.1.0.</p>
<h2 id="the-short-answer">The short answer</h2>
<div class="card-grid" style="--min-width: 250px;"><div class="card"><strong>Reach for Structurizr</strong>
When the same system needs more than one diagram. You describe the model once and generate every view from it, so a renamed container changes in one place.</div><div class="card"><strong>Reach for Mermaid</strong>
When the diagram must render where it lives, in a README or a wiki, with no build step and no renderer to install.</div><div class="card"><strong>Reach for PlantUML</strong>
When layout quality matters most. Graphviz routes edges around boxes, and no other option here does.</div></div><style>
  .card-grid {
    display: grid;
    gap: 1rem;
    margin: 1.5rem 0;
    grid-template-columns: repeat(auto-fit, minmax(var(--min-width), 1fr));
  }

  .card-grid .card>strong:first-child,
  .card-grid .card>h1:first-child,
  .card-grid .card>h2:first-child,
  .card-grid .card>h3:first-child,
  .card-grid .card>h4:first-child,
  .card-grid .card>h5:first-child,
  .card-grid .card>h6:first-child {
    font-size: 1.1em;
    display: block;
    margin-bottom: 0.75rem;
    margin-top: 0;
    color: var(--text-color);
  }

  .card-grid .card {
    color: var(--text-color);
    background-color: var(--background-color);
    border: 2px solid var(--border-color, #e0e0e0);
    border-radius: 8px;
    padding: 1.25rem;
    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
  }

   
  .blog-card {
    display: flex;
    flex-direction: column;
    transition: transform 0.2s ease, box-shadow 0.2s ease;
  }

  .blog-card:hover {
    transform: translateY(-2px);
    box-shadow: 0 4px 8px rgba(0, 0, 0, 0.15);
  }

  .blog-card-header {
    display: flex;
    flex-direction: column;
    align-items: left;
    gap: 1rem;
    margin-bottom: 0.75rem;
  }

  .blog-logo {
    object-fit: contain;
    flex-shrink: 0;
    border-radius: 4px;
    background: var(--background-color);
    padding: 4px;
  }

  .blog-logo.blog-logo-sized {
    box-sizing: border-box;
  }

  .blog-logo-sized {
    width: var(--logo-size, 64px);
    height: var(--logo-size, 64px);
    max-width: var(--logo-size, 64px);
    max-height: var(--logo-size, 64px);
  }

  .blog-title {
    margin: 0;
    font-size: 1.1em;
    text-align: center;
  }

  .blog-title a {
    color: var(--text-color);
    text-decoration: none;
  }

  .blog-title a:hover {
    text-decoration: underline;
  }

  .blog-description {
    margin: 0 0 1rem 0;
    color: var(--text-color);
    opacity: 0.9;
    line-height: 1.5;
    flex: 1;
  }

  .blog-card-items {
    margin: 0;
    padding-left: 1.25rem;
    color: var(--text-color);
    line-height: 1.5;
    flex: 1;
  }

  .blog-card-items li {
    margin-bottom: 0.25rem;
  }

  .blog-links {
    display: flex;
    align-items: center;
    gap: 1rem;
    margin-top: auto;
  }

  .blog-link {
    color: var(--link-color, #0066cc);
    text-decoration: none;
    font-weight: 500;
    display: inline-block;
  }

  .blog-link:hover {
    text-decoration: underline;
  }

   
  .searchable-blog-cards {
    margin: 1.5rem 0;
  }

  .searchable-blog-cards .blog-cards-search-input {
    display: block;
    width: 100%;
    max-width: 24rem;
    margin-bottom: 1rem;
    padding: 0.5rem 0.75rem;
    font-size: 1rem;
    border: 2px solid var(--border-color, #e0e0e0);
    border-radius: 6px;
    background: var(--background-color);
    color: var(--text-color);
  }

  .searchable-blog-cards .blog-cards-search-input:focus {
    outline: none;
    border-color: var(--link-color, #0066cc);
  }

  .searchable-blog-cards .blog-card.hidden {
    display: none;
  }

  .visually-hidden {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border: 0;
  }
</style>

<p>These are not three competitors for one slot. Structurizr exports PlantUML and Mermaid, so the real choice is whether you keep a model upstream of whichever renderer you already use.</p>]]></description></item><item><title>jq vs yq: Which One Should You Use?</title><link>https://jeffbailey.us/blog/2026/09/20/jq-vs-yq/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/20/jq-vs-yq/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>X vs X</category><category>Command Line</category><category>Developer Tools</category><description><![CDATA[<p>Both tools filter structured data with a similar language, so the question looks like a choice. It usually isn&rsquo;t. jq reads JSON; yq reads YAML and four other formats, and writes them back with your comments intact. Most people end up with both installed.</p>
<p>This compares them where they actually differ: file formats, syntax compatibility, in-place editing, and speed. Everything below was run with jq 1.8.2 and yq v4.53.6 (the Go one) on the same files.</p>]]></description></item><item><title>How to Use jq With kubectl: Practical Recipes</title><link>https://jeffbailey.us/blog/2026/09/20/how-do-i-use-jq-with-kubectl/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/20/how-do-i-use-jq-with-kubectl/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>How X</category><category>Command Line</category><category>Containers</category><description><![CDATA[<p><code>kubectl get pods</code> answers the easy questions. The moment you need something it has no column for, which containers have no memory limit, which images the cluster actually runs, which pods restarted most, you reach for <code>-o json</code> and a filter.</p>
<p>These recipes ran against a live two-node k3s cluster (Kubernetes 1.35) with jq 1.8.2, including a deliberately broken deployment so the failure output is real. Swap the namespaces for yours.</p>]]></description></item><item><title>Fix: src refspec main does not match any</title><link>https://jeffbailey.us/blog/2026/09/20/git-src-refspec-does-not-match-any/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/20/git-src-refspec-does-not-match-any/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Git</category><category>Command Line</category><category>Developer Tools</category><description><![CDATA[<p>You created the repository, added the remote, ran the push, and Git answered with this:</p>
<pre><code class="language-text">error: src refspec main does not match any
error: failed to push some refs to &#39;git@github.com:you/your-repo.git&#39;</code></pre><p>The message is about your machine, not the server. <code>git push origin main</code> asks Git to send a local branch named <code>main</code>, and Git is saying no such branch exists here. Four things cause that, and the first two account for most of it. All output below came from Git 2.55.</p>]]></description></item><item><title>Fix: Host Key Verification Failed</title><link>https://jeffbailey.us/blog/2026/09/20/ssh-host-key-verification-failed/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/20/ssh-host-key-verification-failed/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Security</category><category>System Administration</category><category>Command Line</category><description><![CDATA[<p>SSH refuses to connect and prints one of two things. They look similar and mean different things, so read yours before you change anything.</p>
<pre><code class="language-text">Host key verification failed.</code></pre><p>The line above it is the one that matters. This guide covers both forms, tested with OpenSSH 10.3.</p>
<h2 id="which-message-did-you-get">Which Message Did You Get?</h2>
<h3 id="the-host-is-unknown">The host is unknown</h3>
<pre><code class="language-text">No ED25519 host key is known for github.com and you have requested strict checking.
Host key verification failed.</code></pre><p>You&rsquo;ve never connected to this host, and <code>StrictHostKeyChecking=yes</code> refuses to accept a key it hasn&rsquo;t seen. Routine. Go to &ldquo;Add a host key you trust&rdquo;.</p>]]></description></item><item><title>About</title><link>https://jeffbailey.us/about/</link><guid isPermaLink="true">https://jeffbailey.us/about/</guid><pubDate>Sun, 20 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><description><![CDATA[<p>I&rsquo;m Jeff Bailey, a principal software engineer. I&rsquo;ve worked at <a href="https://www.nike.com/">Nike</a> since 2019, first on the product customization platform and now on tech modernization and platform work: enterprise architecture, cloud cost optimization, and the InnerSource and open source practices that let teams share code instead of rebuilding it.</p>
<p>I&rsquo;m a <a href="https://www.credly.com/badges/9ccf3d71-3e0c-4491-819f-a6e1e71305f2/linked_in?t=st6qaz">FinOps Certified Practitioner</a> and a board member at <a href="https://innersourcecommons.org/">InnerSource Commons</a>. Before Nike I consulted for clients across retail, healthcare, and construction software. I&rsquo;ve been writing code since the start of my career in the 90s, back through Earthlink and the early web. The full history is on my <a href="https://jeffbailey.us/resume/">resume</a>.</p>]]></description></item><item><title>Confusion as a Service - Deadly Cut 17</title><link>https://jeffbailey.us/blog/2026/09/03/death-by-1000-cuts-17-confusion-as-a-service/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/09/03/death-by-1000-cuts-17-confusion-as-a-service/</guid><pubDate>Thu, 03 Sep 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Death By 1000 Cuts</category><category>Culture</category><description><![CDATA[<p>Have you ever worked with someone who leaves confusion everywhere they go? You are having a level-headed conversation about something simple, work is moving, and then they arrive. What follows is <em><strong>Confusion as a Service (CaaS)</strong></em>: a relentless focus on things that do not matter in any universe.</p>
<p>Before they show up, my mind sits in a tranquil pool. The reality I am working in is distilled and full of purpose, and I am making real strides toward the goal.</p>]]></description></item><item><title>Why Do I Need an Ontology?</title><link>https://jeffbailey.us/blog/2026/08/26/why-do-i-need-an-ontology/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/08/26/why-do-i-need-an-ontology/</guid><pubDate>Wed, 26 Aug 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Why X</category><category>AI</category><category>Software Engineering</category><description><![CDATA[<h2 id="introduction">Introduction</h2>
<p>Imagine an AI that approves a second refund on the same order. Its reasoning is clear, and the tool call is correct. Yet, the refund remains wrong, and system knowledge isn&rsquo;t enough to stop it, since the rule &ldquo;one order gets one refund&rdquo; exists only in someone&rsquo;s mind.</p>
<p>That rule belongs in an ontology. By the end of this article, you&rsquo;ll understand what an ontology is, why developers have always needed one, and why agents and LLMs need a robust one more than ever.</p>]]></description></item><item><title>Learn Mermaid</title><link>https://jeffbailey.us/blog/2026/08/14/learn-mermaid/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/08/14/learn-mermaid/</guid><pubDate>Fri, 14 Aug 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Learn X</category><category>Software</category><category>Developer Tools</category><description><![CDATA[<p><strong>Quick Start:</strong> This guide gets you writing Mermaid diagrams that render on GitHub in about 15 minutes. Learn the two diagram types that cover most real work, then build a deployment pipeline diagram you can drop into any README.</p>
<h2 id="what-youll-learn">What You&rsquo;ll Learn</h2>
<ul>
<li>What is Mermaid, and what problem does it solve?</li>
<li>What are the use cases for Mermaid?</li>
<li>When is Mermaid <em>not</em> the right tool?</li>
<li>Which two diagram types cover most real work?</li>
<li>How do you build a pipeline diagram and publish it on GitHub?</li>
<li>Where can you go to learn more about Mermaid?</li>
</ul>
<h2 id="the-basics">The Basics</h2>
<p><a href="https://mermaid.js.org/">Mermaid</a> is an open-source tool that turns short text descriptions into diagrams. Type <code>A --&gt; B</code> and you get two boxes connected by an arrow. Knut Sveidqvist created it in 2014 so diagrams could live where code lives: in plain text, in version control, reviewed in pull requests like everything else.</p>]]></description></item><item><title>How Do I Use Lima?</title><link>https://jeffbailey.us/blog/2026/08/14/how-do-i-use-lima/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/08/14/how-do-i-use-lima/</guid><pubDate>Fri, 14 Aug 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>Containers</category><category>macOS</category><category>Developer Tools</category><description><![CDATA[<p>Lima enables you to run a Linux machine on your Mac for free. This tutorial helps you install Lima, launch a Linux VM, verify shared files, and run a web server in a container accessible via your browser.</p>
<p>If you want the concepts first, read <a href="https://jeffbailey.us/blog/2026/01/31/what-is-lima/">What Is Lima?</a> and come back. This article stays hands-on.</p>
<h2 id="what-youll-build">What You&rsquo;ll Build</h2>
<p>A working Lima setup: an Ubuntu virtual machine (VM) running on your Mac, managed from your terminal, serving a containerized nginx web page at <code>localhost:8080</code>.</p>]]></description></item><item><title>What Is Envoy?</title><link>https://jeffbailey.us/blog/2026/08/13/what-is-envoy/</link><guid isPermaLink="true">https://jeffbailey.us/blog/2026/08/13/what-is-envoy/</guid><pubDate>Thu, 13 Aug 2026 00:00:00 +0000</pubDate><dc:creator>Jeff Bailey</dc:creator><category>What X</category><category>DevOps</category><category>Software Architecture</category><description><![CDATA[<p>Run <code>kubectl get pods</code> in a Kubernetes cluster with Istio installed, and every application pod shows <code>2/2</code> containers. You deployed one container. The second is Envoy, and it now handles every byte of network traffic your application sends or receives.</p>
<p>Envoy is an open-source, high-performance proxy for cloud-native systems. It handles networking tasks like routing, retries, timeouts, load balancing, encryption, and telemetry, replacing application-managed functions. By the end of this article, you&rsquo;ll understand why Envoy exists, how its configuration works, and why Kubernetes tools such as Istio, Envoy Gateway, Contour, and Emissary build on it.</p>]]></description></item></channel></rss>