<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Portfolio on Daryl J. White</title>
    <link>https://djw.fyi/portfolio/</link>
    <description>Recent content in Portfolio on Daryl J. White</description>
    <generator>Hugo -- 0.154.5</generator>
    <language>en-us</language>
    <lastBuildDate>Tue, 10 Mar 2026 00:00:00 +0000</lastBuildDate>
    <atom:link href="https://djw.fyi/portfolio/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>How I Integrated Claude Into a Documentation Workflow — and What It Actually Changed</title>
      <link>https://djw.fyi/portfolio/integrating-ai/</link>
      <pubDate>Tue, 10 Mar 2026 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/integrating-ai/</guid>
      <description>&lt;figure&gt;
    &lt;img loading=&#34;lazy&#34; src=&#34;https://djw.fyi/helping-hand.jpg&#34;
         alt=&#34;Close up photo of a hand stretched out with palm facing up in a gesture of assistance or help.&#34;/&gt; &lt;figcaption&gt;
            &lt;p&gt;Photo by &lt;a href=&#34;https://www.pexels.com/@pixabay/&#34;&gt;Pixabay&lt;/a&gt; on &lt;a href=&#34;https://www.pexels.com/photo/close-up-of-hand-over-white-background-255527/&#34;&gt;Pexels&lt;/a&gt;.&lt;/p&gt;
        &lt;/figcaption&gt;
&lt;/figure&gt;

&lt;p&gt;AI tools are everywhere in documentation conversations right now, but most of the discussion stays abstract.
This is a concrete account of how I integrated Claude into MinIO&amp;rsquo;s documentation workflow:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;what I used it for.&lt;/li&gt;
&lt;li&gt;how I structured that use.&lt;/li&gt;
&lt;li&gt;what it measurably changed about how the team worked.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;h2 id=&#34;the-starting-point&#34;&gt;The Starting Point&lt;/h2&gt;
&lt;p&gt;Technical documentation for a product like MinIO lives close to the codebase.
Keeping it accurate means tracking software releases, triaging GitHub issues, auditing existing content, and staying current with a fast-moving engineering team.
All while writing new content and updating existing content.
The surface area is large and the feedback loops are long.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Engineering the &#34;Golden Path&#34;</title>
      <link>https://djw.fyi/portfolio/golden-path/</link>
      <pubDate>Thu, 05 Mar 2026 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/golden-path/</guid>
      <description>&lt;h2 id=&#34;modernizing-documentation-at-cloud-scale&#34;&gt;Modernizing Documentation at Cloud Scale&lt;/h2&gt;
&lt;p&gt;In the world of high-performance distributed systems, documentation is more than just a manual.
Instead, the docs serve as a critical component of the user’s infrastructure.
During my tenure as a Senior Technical Writer at MinIO, I transitioned from being a content creator to a &amp;ldquo;Documentation Architect.&amp;rdquo;&lt;/p&gt;
&lt;p&gt;My GitHub contributions reflect the level of work:&lt;/p&gt;
&lt;figure&gt;
    &lt;img loading=&#34;lazy&#34; src=&#34;https://djw.fyi/djw-2026-GitHub.png&#34;
         alt=&#34;GitHub metric contributions for my profile, djwfyi, showing 839 contributions during the previous year from March 2025 through March 2026. 22% to conde reviews, 31% to commits, 20% to issues, and 27% to pull requests across two MinIO organizations and the Write the Docs repository.&#34;/&gt; &lt;figcaption&gt;
            &lt;p&gt;My GitHub metric contributions for the year leading up to February 2026.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Feature - Node Maintenance</title>
      <link>https://djw.fyi/portfolio/minio-node-maintenance/</link>
      <pubDate>Mon, 22 Dec 2025 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/minio-node-maintenance/</guid>
      <description>&lt;p&gt;MinIO introduced a new feature to AIStor for taking a node offline for maintenance.
For this feature, I needed to explain how the feature works.
As an AIStor feature applicable both in Kubernetes and non-Kubernetes environments, it was also important to distinguish it from the similar &lt;code&gt;kubectl cordon&lt;/code&gt; functionality system administrators would also be familiar with.&lt;/p&gt;
&lt;p&gt;Some notes:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The quote block text used a shortcode in the theme we used to create admonitions.&lt;/li&gt;
&lt;li&gt;For the diagram, I used a skill another team member had created for Claude to use for creating SVG diagrams.&lt;/li&gt;
&lt;li&gt;Links in the text here are intentionally broken, but would have cross-linked to other pages in the docs.&lt;/li&gt;
&lt;/ul&gt;
&lt;hr&gt;
&lt;p&gt;AIStor allows you to temporarily remove nodes from active service for planned maintenance operations.
Removing nodes allows administrators to gracefully take nodes offline without disrupting cluster operations, similar to the &lt;a href=&#34;#&#34;&gt;cordon functionality in Kubernetes&lt;/a&gt;.
A cordoned node finishes in-flight operations and marks itself as unavailable for any other operation.
Use this to do hardware maintenance on a node, complete operating system updates, or perform troubleshooting.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Explanatory doc - MinIO Warp</title>
      <link>https://djw.fyi/portfolio/test-types/</link>
      <pubDate>Tue, 07 Oct 2025 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/test-types/</guid>
      <description>&lt;p&gt;&lt;a href=&#34;https://github.com/minio/warp&#34;&gt;MinIO Warp&lt;/a&gt; is an open-source tool for testing storage performance.
It allows you to plan capacity and make sure the infrastructure meets requirements.&lt;/p&gt;
&lt;p&gt;After MinIO&amp;rsquo;s migration to Hugo for documentation, I went about the task of adding documentation for Warp that previously only existed in the upstream code repositories.&lt;/p&gt;
&lt;p&gt;This particular document covers two types of tests Warp provides.
I put it together using some existing documentation and code examples in the repository combined with a deep dive analysis of the code using Claude, a review by a MinIO team member that uses the product regularly during support calls, and my own testing.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Feature Plan (sample)</title>
      <link>https://djw.fyi/portfolio/feature-plan/</link>
      <pubDate>Sun, 22 Aug 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/feature-plan/</guid>
      <description>&lt;p&gt;In planning out a new feature, the Product Manager wrote out an issue card in GitHub for developers to reference.
The card included the PM&amp;rsquo;s notes from visits on site with customers.&lt;/p&gt;
&lt;p&gt;I updated the card by:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Removing extraneous verbiage&lt;/li&gt;
&lt;li&gt;Adding sections and rearranging content&lt;/li&gt;
&lt;li&gt;Updating references to existing product features&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Some portions of the issue make sense within the broader product portfolio.
Those have been left without further explanation in the edited card, as such additional information is already known to the development team.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Assetly (Concept Sample)</title>
      <link>https://djw.fyi/portfolio/assetly/</link>
      <pubDate>Wed, 18 Aug 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/assetly/</guid>
      <description>&lt;h1 id=&#34;about-this-sample&#34;&gt;About this sample&lt;/h1&gt;
&lt;p&gt;The information below is about a fictitious software product, &amp;ldquo;Assetly.&amp;rdquo;
I based Assetly on a real product I documented, though many details have changed in this document.&lt;/p&gt;
&lt;p&gt;I wrote the original product document in Madcap Flare in consultation with a number of subject matter experts, including:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Product Manager&lt;/li&gt;
&lt;li&gt;Developers&lt;/li&gt;
&lt;li&gt;Quality Assurance team&lt;/li&gt;
&lt;li&gt;Sales team members who championed the product&lt;/li&gt;
&lt;li&gt;Product Team Executives&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;This sample reimagines the original document, now written in Markdown for use in this blog.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Assetly Group Schedule (Task Sample)</title>
      <link>https://djw.fyi/portfolio/assetly-group-schedule-task/</link>
      <pubDate>Wed, 18 Aug 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/assetly-group-schedule-task/</guid>
      <description>&lt;h1 id=&#34;about-this-sample&#34;&gt;About this sample&lt;/h1&gt;
&lt;p&gt;The information below is about a task a user would need to complete in a fictitious software product, &amp;ldquo;Assetly.&amp;rdquo;
I based Assetly on a real product I documented, though many details have changed in this document.&lt;/p&gt;
&lt;p&gt;I wrote the original document in Madcap Flare based on my own use of the software.&lt;/p&gt;
&lt;p&gt;During my use of the real product, I occasionally uncovered bugs or more complicated problems.
When discovered, I created issue cards in the development team&amp;rsquo;s issue tracking system.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Business Requirements (sample)</title>
      <link>https://djw.fyi/portfolio/business-requirements/</link>
      <pubDate>Thu, 12 Aug 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/business-requirements/</guid>
      <description>&lt;p&gt;&lt;strong&gt;About this sample&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;For a job application process, I was asked to revise a sample &lt;strong&gt;business requirements document&lt;/strong&gt;.
The provided example was a template purporting to be notes from several different meetings.&lt;/p&gt;
&lt;p&gt;I left the headings from the template as they were, but edited and formatted the contents of each section.&lt;/p&gt;
&lt;p&gt;While the original sample was done in Word, I have recreated it here with Markdown, published by my SSG, &lt;a href=&#34;https://gohugo.io&#34;&gt;Hugo&lt;/a&gt;.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Converting to Flare</title>
      <link>https://djw.fyi/portfolio/converting-to-flare/</link>
      <pubDate>Thu, 12 Aug 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/converting-to-flare/</guid>
      <description>&lt;p&gt;My first job at a software company landed me in a software training role.
While I learned a great deal about adult learning and best practices for knowledge transfer, my proudest achievement while I was there involved &lt;strong&gt;project management&lt;/strong&gt;.&lt;/p&gt;
&lt;p&gt;Our department had a catalog of 160 course manuals.
These manuals varied in length from 20 pages to several hundred pages.
These were course guides for the various training classes taught by everyone in our department.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Choosing a doc toolkit</title>
      <link>https://djw.fyi/portfolio/choosing-a-platform/</link>
      <pubDate>Mon, 12 Jul 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/choosing-a-platform/</guid>
      <description>&lt;figure&gt;
    &lt;img loading=&#34;lazy&#34; src=&#34;https://djw.fyi/pexels-cottonbro-4488651.jpg&#34;
         alt=&#34;An overhead light shines down on a garage work bench full of tools that spread up the wall on a pegboard.&#34;/&gt; &lt;figcaption&gt;
            &lt;p&gt;Photo by &lt;a href=&#34;https://www.pexels.com/@cottonbro/&#34;&gt;&lt;strong&gt;Cottonbro Studios&lt;/strong&gt;&lt;/a&gt; from &lt;a href=&#34;https://www.pexels.com/photo/white-and-red-plastic-container-on-black-table-4488651/&#34;&gt;&lt;strong&gt;Pexels&lt;/strong&gt;&lt;/a&gt;.&lt;/p&gt;
        &lt;/figcaption&gt;
&lt;/figure&gt;

&lt;p&gt;I have spent the last year at my current job working on transitioning our docs from Madcap Flare to &lt;a href=&#34;https://antora.org/&#34; title=&#34;Antora Project&#34;&gt;Antora&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;First things, Madcap Flare is a great tool. This is the third place I have worked that has used Flare for some form of documentation, and it does its job well. However, there are several factors that impacted the decision to move away from Flare to another tool.&lt;/p&gt;</description>
    </item>
    <item>
      <title>Building a Portfolio Site</title>
      <link>https://djw.fyi/portfolio/building-a-portfolio-site/</link>
      <pubDate>Mon, 28 Jun 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/building-a-portfolio-site/</guid>
      <description>&lt;figure&gt;
    &lt;img loading=&#34;lazy&#34; src=&#34;https://djw.fyi/pexels-vojtech-okenka-392018.jpg&#34;
         alt=&#34;A person sitting at a desk with a monitor, keyboard, and mouse. The angle focuses on the hand holding a pen on top of the computer mouse.&#34;/&gt; &lt;figcaption&gt;
            &lt;p&gt;Photo by &lt;a href=&#34;https://www.pexels.com/@vojtech-okenka-127162?utm_content=attributionCopyText&amp;amp;utm_medium=referral&amp;amp;utm_source=pexels&#34;&gt;&lt;strong&gt;Vojtech Okenka&lt;/strong&gt;&lt;/a&gt; from &lt;a href=&#34;https://www.pexels.com/photo/person-holding-apple-magic-mouse-392018/?utm_content=attributionCopyText&amp;amp;utm_medium=referral&amp;amp;utm_source=pexels/&#34;&gt;&lt;strong&gt;Pexels&lt;/strong&gt;&lt;/a&gt;.&lt;/p&gt;
        &lt;/figcaption&gt;
&lt;/figure&gt;

&lt;h2 id=&#34;tldr&#34;&gt;TL;DR&lt;/h2&gt;
&lt;p&gt;Here&amp;rsquo;s what I did to create this site and give myself a (well, almost) free site to build out a portfolio.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Create an account with a Git service provider.&lt;br&gt;
I used &lt;a href=&#34;https://gitlab.com/&#34;&gt;GitLab&lt;/a&gt; I already had, but &lt;a href=&#34;https://github.com&#34;&gt;GitHub&lt;/a&gt; also works.&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;https://forestry.io/starters/&#34;&gt;Select a starter template from Forestry.io&lt;/a&gt; for the desired SSG (static site generator) and create it on Forestry. Forestry.io automatically adds a new repository and branch on your Git provider.&lt;br&gt;
(I used the &lt;a href=&#34;https://hylia-forestry.netlify.app/&#34;&gt;Hylia template&lt;/a&gt; for &lt;a href=&#34;https://www.11ty.dev&#34;&gt;11ty&lt;/a&gt;.)&lt;/li&gt;
&lt;li&gt;Authenticate with your Git service provider and import the site to Forestry.&lt;/li&gt;
&lt;li&gt;Publish the site to &lt;a href=&#34;https://www.netlify.com/&#34;&gt;Netlify&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Add content using Forestry.io&amp;rsquo;s headless CMS WYSIWYG editor, and Netlify automatically finds the changes as you make them and updates your site in nearly real time.&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;update&#34;&gt;Update&lt;/h2&gt;
&lt;p&gt;In anticipation of different responsibilities brought on by a job change, I modified how I create my site.&lt;/p&gt;</description>
    </item>
    <item>
      <title>My Tech Writing Journey</title>
      <link>https://djw.fyi/portfolio/my-tech-writing-journey/</link>
      <pubDate>Sun, 27 Jun 2021 00:00:00 +0000</pubDate>
      <guid>https://djw.fyi/portfolio/my-tech-writing-journey/</guid>
      <description>&lt;p&gt;My journey into tech writing started in 2013.&lt;/p&gt;
&lt;h2 id=&#34;reynolds-and-reynolds&#34;&gt;Reynolds and Reynolds&lt;/h2&gt;
&lt;h3 id=&#34;software-training&#34;&gt;Software Training&lt;/h3&gt;
&lt;p&gt;I started out my journey into the world of talking and writing about technology and software as a customer trainer at Reynolds and Reynolds. A provider of software and other services for car dealerships, I taught dealership personnel and new ReyRey hires how to use the accounting and payroll portions of the software.&lt;/p&gt;
&lt;p&gt;I taught mostly online, interactive webinars over Webex, making use of their Hands-on Lab feature. I also taught in-person, intensive classes for dealership controllers and office managers and as a deep-dive into my specialty for recent Reynolds and Reynolds hires.&lt;/p&gt;</description>
    </item>
  </channel>
</rss>
