From 7f1e19fe85cae401ab720502da786d4ce4ea25a5 Mon Sep 17 00:00:00 2001 From: Dan Connolly Date: Fri, 9 Oct 2026 01:25:13 -0500 Subject: [PATCH] potluck: README: two sentences, then getting started, then features Generated-by: Claude Opus 5.5 --- potluck/README.md | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/potluck/README.md b/potluck/README.md index 62bcb56..09ca918 100644 --- a/potluck/README.md +++ b/potluck/README.md @@ -1,17 +1,7 @@ # potluck -A weekly zine of what you found elsewhere: each issue is one ISO week -(`/issues/2026-w40`) of bookmarks with a few words of editorial around -them. Everyone brings a dish. The bookmarks come from your own diigo -account, so the web you read becomes something you publish on your own -site ([PESOS](https://indieweb.org/PESOS)). For now issues are put -together by hand. Pulling a week from diigo-cache is next. - -Plain HTML that's easy to read, with -[microformats](https://microformats.org/wiki/h-entry) so feed readers -and IndieWeb tools see each issue as an `h-entry` and each bookmark as -an `h-cite`. It's an [EmDash](https://docs.emdashcms.com/) site, so you -edit issues in a real admin UI, and it runs on Cloudflare Workers. +A weekly zine of what you bookmarked elsewhere, published on your own +site. Each issue is one week of links with a few words around them. ## Getting started @@ -22,5 +12,19 @@ pnpm seed:issues # three sample issues, W38–W40 of 2026 pnpm dev # → http://localhost:4321/issues ``` -Next: [CONTRIBUTING](CONTRIBUTING.md) covers how it's put together, -checks, and deploying. +## What's in it + +- **Your web, your site:** the bookmarks come from your own diigo + account, so the web you read becomes something you publish + ([PESOS](https://indieweb.org/PESOS)). For now issues are put + together by hand. Pulling a week from diigo-cache is next. +- **A week per issue:** `/issues/2026-w40`, by ISO week, UTC. +- **Microformats:** feed readers and IndieWeb tools see each issue as an + [h-entry](https://microformats.org/wiki/h-entry) and each bookmark as + an [h-cite](https://microformats.org/wiki/h-cite). +- **Plain HTML** that's easy to read: system fonts, one column. +- **A real editor:** it's an [EmDash](https://docs.emdashcms.com/) site, + so you write issues in its admin UI, and it runs on Cloudflare Workers. + +How it's put together, checks, and deploying: +[CONTRIBUTING](CONTRIBUTING.md).