For AI agents: a documentation index is available at /llms.txt — markdown versions of all pages are available by appending index.md to any URL path.
202 Posts

Microblog

Short posts that don't need a full article. Most of these started life on LinkedIn (each one links to the original); from here on they get written here first and syndicated there. Subscribe to the microblog RSS feed if you'd rather not follow along on LinkedIn. The main feed still only carries full articles.

DocumentationPersonalBusiness

Exciting announcement time: after 14 years as a contractor, I've finally hung up my freelance hat to go to work full-time for Tugboat !!!

As of today, I'm officially starting as "Technical Content Strategist" for Tugboat; a role that's part marketing, and part technical documentarian. I'm so excited to be joining the talented team alongside Ben Chavet, James Sansbury, Matt Westgate (he-him), and a TBA additional member of our crew ;)

Many thanks to the Tugboat crew for making me feel like a member of the team in the past year while I've been contracting for them, even before making the transition to full employee. I'm so delighted to make it official!

And thanks to the Lullabot leadership team, our parent company, for taking the leap of faith to devote resources to this awesome tool. I've really enjoyed working with the Lullabot crew, and am so glad to be joining the team.

This is a deeply weird time, and none of us can predict what the future holds, but I am filled with optimism to be joining this team and seeing what we can accomplish together.

Documentation

In a month of part-time work at my new #technicalwriting gig, I have spun up on their #software, crash-coursed on a couple of ancillary #technologies, consumed all of their existing documentation, built out a matrix for their #documentation redesign, and created a new version of their doc site.

The new doc site translates to 106 pages when printed as a PDF. Probably ~70-80 pages of that is new material. I'd estimate I have another 10-15 pages to draft, and then I might be able to reduce the volume of docs by tightening up the new organization a bit, and removing some stuff through content reuse.

Not bad for a month of part-time work!