Skip to content

fix(docs): repoint deploy at zoolutions org and bump docs-kit to 1.0.8 - #36

Merged
mhenrixon merged 2 commits into
mainfrom
fix/org-move-zoolutions
Aug 16, 2026
Merged

mhenrixon merged 2 commits into
mainfrom
fix/org-move-zoolutions

Conversation

@mhenrixon

@mhenrixon mhenrixon commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Same fix as pgbus#408 / docs-kit#70: reusable-workflow uses: refs do not follow repo redirects, so the docs deploy has been failing at parse time since the org move.

  • .github/workflows/deploy-docs.ymlzoolutions/docs-kit/.github/workflows/deploy.yml@main, image: zoolutions/daisyui; same image: in docs/config/deploy.yml (kept registry.username: mhenrixon — acting ghcr login, not package owner)
  • docs-kit ~> 1.0.3~> 1.0.8; ran the 1.0.7 version-aware docs_kit:install --sync (refreshed the OG rake task template); kept the sync stamp below # frozen_string_literal: true (the generator prepends it to line 1, which disables the magic comment)
  • Moved github.com/mhenrixon/* URLs in docs content → zoolutions (the sync's AGENTS.md block re-stamped the old URL from the released gem's template — re-fixed here; goes away once docs-kit#70 ships in a release)
  • bun run build:css rebuilt; bun.lock normalizes "latest" to resolved ranges (current bun behavior)

Test plan

  • docs/: bundle exec rspec — 8 examples, 0 failures
  • docs/: bundle exec rubocop — no offenses
  • actionlint .github/workflows/deploy-docs.yml
  • After merge: workflow_dispatch Deploy docs; check the new zoolutions/daisyui ghcr package visibility once

Deviations & judgment calls

  • None beyond the pattern established in pgbus#408 (username/twitter-handle kept, Rails 8.1.3.1 patch rides along with the bundle refresh).

Summary by cubic

Fixes broken docs deploys after the org move by repointing the reusable workflow and container image to the zoolutions org and syncing docs-kit 1.0.8. Old: uses: mhenrixon/docs-kit and image mhenrixon/daisyui (reusable workflows don’t follow redirects → parse-time failure). New: uses: zoolutions/docs-kit and image zoolutions/daisyui, plus template sync and a RuboCop-compliant OG rake task.

  • .github/workflows/deploy-docs.yml now uses zoolutions/docs-kit/.github/workflows/deploy.yml@main and image: zoolutions/daisyui; mirrored in docs/config/deploy.yml (image owner matches repo for GHCR auto-linking).
  • Bumps docs-kit to ~> 1.0.8 and runs the version-aware sync; stamps docs/config/initializers/docs_kit.rb and refreshes the OG task; restyles the synced lib/tasks/docs_kit_og.rake to pass this site's RuboCop.
  • Updates docs content links to https://github.com/zoolutions/docs-kit; rebuilds CSS; normalizes bun.lock “latest” to ranges; Gemfile.lock includes patch updates (e.g., Rails 8.1.38.1.3.1).
  • After merge: trigger Deploy docs via workflow_dispatch and confirm zoolutions/daisyui GHCR package visibility.

Written for commit 3f2f4bf. Summary will update on new commits.

Review in cubic

Reusable-workflow `uses:` refs do not follow GitHub repo redirects, so the
docs deploy broke after the mhenrixon -> zoolutions org move.

- deploy-docs.yml -> zoolutions/docs-kit, image zoolutions/daisyui (image must
  match the repo owner for ghcr package auto-linking); same in docs/config/deploy.yml
- docs-kit ~> 1.0.3 -> ~> 1.0.8 + version-aware sync (og rake template refresh);
  sync stamp kept below the frozen_string_literal magic comment
- moved github.com/mhenrixon/* URLs in docs content -> zoolutions
- CSS rebuilt; bun.lock normalizes "latest" to resolved ranges

Verification: docs rspec 8 examples 0 failures; rubocop clean; actionlint clean

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 9 files

Re-trigger cubic

The docs-kit 1.0.8 sync refreshed lib/tasks/docs_kit_og.rake from the gem
template, whose style (no trailing comma, path-string Rails.root.join)
violates this site's stricter docs rubocop (Style/TrailingCommaInHashLiteral,
Rails/FilePath EnforcedStyle: arguments) — the Docs Lint job caught it.

Autocorrected via bin/rubocop -a; 344 files inspected, no offenses.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

0 issues found across 1 file (changes from recent commits).

Re-trigger cubic

@mhenrixon
mhenrixon merged commit d8e8821 into main Aug 16, 2026
8 checks passed
@mhenrixon
mhenrixon deleted the fix/org-move-zoolutions branch August 16, 2026 13:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant