Skip to content

Releases: MobileByteLabs/mbl-actionhub-docshub

v0.2.0 — composite action repackaging (BREAKING vs v0.1.0)

Choose a tag to compare

@therajanmaurya therajanmaurya released this 02 Jun 09:18
e3e8e0b

Repackaged from reusable workflow → composite action.

Architecture

Consumer's workflow (12 lines)
  ↓ uses: (reusable workflow)
MobileByteLabs/mbl-actionhub/.github/workflows/sync-docs-to-wiki.yml@v1.8.0
  ↓ uses: (composite action)
MobileByteLabs/mbl-actionhub-docshub@v0.2.0  ← this release

Same shape as mbl-actionhub-bump-version + mbl-actionhub-resolve-version (the established pattern).

v0.1.0 → v0.2.0 breaking changes

  • .github/workflows/sync-docs-to-wiki.yml (reusable workflow) DELETED — that role now belongs to mbl-actionhub
  • action.yml ADDED at root — composite action with docs-dir, sidebar-mode, token inputs

Do NOT pin v0.1.0 going forward — the reusable workflow no longer exists at that path.

Direct usage (uncommon)

- uses: actions/checkout@v4
- uses: MobileByteLabs/mbl-actionhub-docshub@v0.2.0
  with:
    docs-dir: docs
    sidebar-mode: auto
    token: ${{ secrets.GITHUB_TOKEN }}

Composite actions can't read secrets.GITHUB_TOKEN directly — caller must pass it explicitly.

v0.1.0 — Initial release

Choose a tag to compare

@therajanmaurya therajanmaurya released this 02 Jun 08:52

First versioned cut of the reusable sync-docs-to-wiki workflow + bundled rewriter.

Consumer surface (12 lines)

name: Sync docs to Wiki
on:
  push:
    branches: [development]
    paths: ['docs/**']
  workflow_dispatch:
permissions:
  contents: write
jobs:
  sync:
    uses: MobileByteLabs/mbl-actionhub-docshub/.github/workflows/sync-docs-to-wiki.yml@v0.1.0

What ships

  • Reusable workflow with docs-dir + sidebar-mode inputs
  • Bundled Python rewriter — auto-derives wiki URL, collision-safe slugs, auto-generated _Sidebar.md
  • Self-test CI asserting all corner cases (collision-safe slugs / sidebar generation / code-block protection / out-of-tree preservation)

One-time per-consumer bootstrap (GitHub UI)

  1. Settings → Features → Wikis (enable)
  2. Wiki tab → "Create the first page" → save anything

Without this the wiki repo doesn't exist and the first sync run fails with Repository not found.

Origins

Consolidates the per-repo wiki-sync forks from worker-kmp, mbl-library-template-kmp, KmpToolkit, kmp-product-flavors. See README.md "Provenance" section for the lineage.

🤖 Generated with Claude Code