Threadiverse tutorial and public audience interop fix

.hongdown.toml

@@ -41,13 +41,19 @@ proper_nouns = [
   "ActivityPub",
   "ActivityStreams",
   "Akkoma",
+  "Biome",
   "BotKit",
   "BrowserPub",
+  "cloudflared",
+  "Cloudflare Tunnel",
   "Cloudflare Workers",
+  "create-next-app",
   "Deno",
   "Deno Deploy",
   "Deno Lint",
   "Docker Compose",
+  "Drizzle Kit",
+  "Drizzle ORM",
   "Fastify",
   "Fedify",
   "Elysia",
@@ -62,34 +68,46 @@ proper_nouns = [
   "Hono",
   "HTTP Message Signatures",
   "HTTP Signatures",
+  "JSX",
   "Koa",
   "Lemmy",
   "Linked Data Signatures",
   "LitePub",
   "LogTape",
   "Mastodon",
+  "Mbin",
   "mise",
   "Misskey",
   "NestJS",
+  "Next.js",
+  "Node.js",
+  "NodeBB",
   "NodeInfo",
+  "ngrok",
   "Object Integrity Proofs",
   "OpenTelemetry",
+  "Piefed",
   "Pixelfed",
   "Pleroma",
   "Podman Compose",
   "RabbitMQ",
   "Redis",
+  "scrypt",
   "Scoop",
+  "Serveo",
   "SiliconBeest",
   "SolidStart",
+  "SQLite",
   "SvelteKit",
+  "TypeScript",
   "Typo Blue",
   "URI Template",
   "URI Templates",
   "Visual Studio Code",
   "VitePress",
   "WebAssembly",
   "WebFinger",
+  "x-forwarded-fetch",
 ]
 
 [code_block.formatters]

CHANGES.md

@@ -42,12 +42,29 @@ To be released.
     `getAuthenticatedDocumentLoader()` now also respects
     `GetAuthenticatedDocumentLoaderOptions.maxRedirection`.
 
+ -  Improved interoperability with threadiverse software by serializing the
+    public audience as the full `https://www.w3.org/ns/activitystreams#Public`
+    URI in outgoing activities' `to`, `cc`, `bto`, `bcc`, and `audience`
+    fields, instead of the compacted `as:Public` or `Public` CURIEs that
+    JSON-LD compaction would otherwise produce.  Some ActivityPub
+    implementations, [Lemmy] included, match those fields as plain URLs
+    without JSON-LD expansion and would silently drop activities carrying
+    the CURIE form; see [LemmyNet/lemmy#6465].  The rewrite is gated on a
+    URDNA2015 canonical-form equivalence check, so an application-defined
+    `@context` that redefines the `as:` prefix or the bare `Public` term
+    is preserved as is.  The rewrite is also applied before
+    `eddsa-jcs-2022` Object Integrity Proof signing so the signed bytes
+    match what is sent on the wire.  [[#710]]
+
 [Agent Skills]: https://agentskills.io/
 [skills-npm]: https://github.com/antfu/skills-npm
+[Lemmy]: https://join-lemmy.org/
+[LemmyNet/lemmy#6465]: https://github.com/LemmyNet/lemmy/issues/6465
 [#430]: https://github.com/fedify-dev/fedify/issues/430
 [#644]: https://github.com/fedify-dev/fedify/issues/644
 [#680]: https://github.com/fedify-dev/fedify/pull/680
 [#688]: https://github.com/fedify-dev/fedify/pull/688
+[#710]: https://github.com/fedify-dev/fedify/pull/710
 [#711]: https://github.com/fedify-dev/fedify/issues/711
 [#712]: https://github.com/fedify-dev/fedify/pull/712
 
@@ -162,6 +179,21 @@ To be released.
 [#656]: https://github.com/fedify-dev/fedify/pull/656
 [#675]: https://github.com/fedify-dev/fedify/pull/675
 
+### Documentation
+
+ -  Added a new tutorial, [*Building a threadiverse community platform*], that
+    walks through building a Lemmy-style community server with Fedify and
+    Next.js.  Where the existing [*Creating your own federated microblog*]
+    tutorial is actor- and timeline-centric, this one is community-centric: it
+    models communities as `Group` actors, threads as `Page` objects wrapped in
+    `Create`, replies as `Note` objects, and the community-side `Announce`
+    redistribution that threadiverse software (Lemmy, Mbin, NodeBB) uses to fan
+    activity out to every subscriber.  [[#704], [#710]]
+
+[*Building a threadiverse community platform*]: https://fedify.dev/tutorial/threadiverse
+[*Creating your own federated microblog*]: https://fedify.dev/tutorial/microblog
+[#704]: https://github.com/fedify-dev/fedify/issues/704
+
 
 Version 2.1.9
 -------------

docs/.vitepress/config.mts

@@ -99,6 +99,10 @@ const TUTORIAL = {
     },
     { text: "Learning the basics", link: "/tutorial/basics.md" },
     { text: "Creating a microblog", link: "/tutorial/microblog.md" },
+    {
+      text: "Building a threadiverse community",
+      link: "/tutorial/threadiverse.md",
+    },
   ],
   activeMatch: "/tutorial",
 };