Docs on Jake Worth

Unknown Value in Brackets

Tue, 07 Jul 2026 12:05:47 -0400

I’m reading How to Open Source by Richard Schneeman (fantastic) and one of his tips is to show documentation code like this (consider documenting ls):

ls <desired-path>

Rather than the common:

ls /your/path/here

Rust Erroring Code Visual Aid

Mon, 06 Jul 2026 11:16:08 -0400

Today while reading the Rust Documentation, I encountered a fantastic UX touch. The authors provide this image with each code block that intentionally doesn’t compile:

A Missing README Isn't a Missing README

Sun, 29 Mar 2026 09:32:47 -0400

A missing README is rarely just missing documentation. It usually signals other things, too.

Read the Docs

Wed, 19 Oct 2022 00:00:00 +0000

When learning a new language or framework, the first thing I do is read the official documentation cover-to-cover.

Improve Your API Documentation Workflow with Dash

Sun, 21 Aug 2022 00:00:00 +0000

One of my all-time favorite programming tools is Dash by Kapeli. In this post, I’ll share some tips for leveraging this fantastic program.

How to Read Postgres Docs

Mon, 21 Mar 2022 00:00:00 +0000

Have you ever tried to read the documentation for a Postgres command? Although many consider Postgres’ docs best-in-class, they include conventions that might challenge newbies. In this post, I’ll paraphrase Postgres’ conventions page to help us understand what the documentation for a command is saying.