From 59afc172b57dccd79df4d63cda81f37f6046ae78 Mon Sep 17 00:00:00 2001 From: Ivan Malison Date: Tue, 10 Feb 2026 20:16:28 -0800 Subject: [PATCH] docs: note manual doc upload requirement for GTK-dependent packages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hackage can't build docs for packages with GTK/GI system deps. This affects taffybar, gtk-sni-tray, gtk-strut, and dbus-menu — docs must be built locally and uploaded manually for those. Co-Authored-By: Claude Opus 4.6 --- dotfiles/agents/skills/taffybar-ecosystem-release/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/dotfiles/agents/skills/taffybar-ecosystem-release/SKILL.md b/dotfiles/agents/skills/taffybar-ecosystem-release/SKILL.md index edbf7a27..796967d5 100644 --- a/dotfiles/agents/skills/taffybar-ecosystem-release/SKILL.md +++ b/dotfiles/agents/skills/taffybar-ecosystem-release/SKILL.md @@ -52,6 +52,8 @@ Use the `hackage-release` skill for the full Hackage publish workflow. In the lo 6. Publish to Hackage 7. Publish docs +**Manual doc upload required for GTK-dependent packages:** Hackage cannot build documentation for packages that depend on GTK/GI libraries (the build servers lack the system dependencies). This affects `taffybar`, `gtk-sni-tray`, `gtk-strut`, and `dbus-menu`. For these packages you must build haddocks locally and upload them yourself — see the `hackage-release` skill for the `cabal haddock --haddock-for-hackage` and `cabal upload --documentation` commands. Only `status-notifier-item` and `dbus-hslogger` (pure DBus/Haskell deps) can have their docs built by Hackage automatically. + ### 2. Update Dependents' Version Bounds For each package higher in the graph that depends on what you just released, update the dependency bound in its `.cabal` file. For example, if you bumped `gtk-strut` to 0.1.5.0: