Skip to main content
← Back to list
01Issue
BugShippedSwamp Club
Assigneesstack72

Relationships

#696 Tutorial extension search "entropy" zero-result example is now stale

Opened by sntxrrgithub · 6/19/2026· Shipped 6/19/2026

Description

The "Publish an Extension" tutorial (https://swamp-club.com/manual/tutorials/publish-an-extension) uses swamp extension search entropy as a worked example of checking the registry before building a new extension. The tutorial shows the interactive browser returning a zero-result state:

entropy 0 / 0 ──────────────────────────────────┬─────────────────────────────────────── No matching extensions found │ ──────────────────────────────────┴─────────────────────────────────────── ↑/↓ navigate Ctrl-u/d scroll preview i install Enter select Esc cancel

and uses that "no existing solution" result as the illustrative reason to proceed with building a new extension.

Running the same query today returns real matches:

$ swamp extension search entropy --json

returns 2 results, including @unlaudable/text-entropy — "Measure the Shannon entropy of a piece of text" — which is exactly the kind of extension the tutorial's example was using as a hypothetical "nothing exists yet" case.

This is doubly confusing for a reader following the tutorial verbatim: not only does the example no longer reproduce a zero-result screen, the registry now contains an extension that directly matches the tutorial's own example query, undermining the "search before you build" lesson the example is meant to teach.

Steps to Reproduce

  1. Open the tutorial at /manual/tutorials/publish-an-extension.
  2. Find the registry search example using the query "entropy".
  3. Run swamp extension search entropy (interactively) or --json for a non-interactive check.
  4. Compare to the tutorial's claimed zero-result screen.

Expected Behavior

Either:

  • Swap the tutorial's example query for one that reliably has zero (or near-zero, stable) matches in the registry, so the walkthrough reproduces as documented, or
  • Make the example registry-agnostic — e.g. describe the zero-result UI in prose/screenshot without asserting a specific query will currently return zero, since registry contents change over time and any live query is liable to go stale.

Affected Component

Documentation — swamp.club manual, "Publish an Extension" tutorial, registry search example section.

Environment

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 4 MOREFINDINGS+ 3 MOREPR_MERGED+ 1 MORECONTRIBUTOR_NOTIFIED

Shipped

6/19/2026, 7:04:40 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack726/19/2026, 6:47:27 PM
Editable. Press Enter to edit.

stack72 commented 6/19/2026, 7:05:09 PM

Thanks @sntxrrgithub for reporting this! The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.