diff --git a/.github/wiki b/.github/wiki deleted file mode 160000 index e5558a0..0000000 --- a/.github/wiki +++ /dev/null @@ -1 +0,0 @@ -Subproject commit e5558a0801a211037754a06b4ce68fc61331cbfb diff --git a/.github/workflows/wiki-maintenance.yml b/.github/workflows/wiki-maintenance.yml deleted file mode 100644 index f8f15d8..0000000 --- a/.github/workflows/wiki-maintenance.yml +++ /dev/null @@ -1,26 +0,0 @@ -name: "Fast Forward Wiki Maintenance" - -on: - pull_request_target: - types: [closed] - schedule: - - cron: '17 3 * * *' - workflow_dispatch: - -permissions: - contents: write - pull-requests: read - -concurrency: - group: fast-forward-wiki-maintenance-${{ github.event.pull_request.number || github.ref }} - cancel-in-progress: true - -jobs: - maintenance: - permissions: - contents: write - pull-requests: read - # This wrapper handles merged publication to the wiki master branch plus - # preview-branch cleanup. Pull-request preview generation lives in wiki.yml. - uses: php-fast-forward/dev-tools/.github/workflows/wiki-maintenance.yml@main - secrets: inherit diff --git a/.github/workflows/wiki.yml b/.github/workflows/wiki.yml index cdf2726..2d6122b 100644 --- a/.github/workflows/wiki.yml +++ b/.github/workflows/wiki.yml @@ -1,25 +1,14 @@ -name: "Fast Forward Wiki Update" +name: Fast Forward Wiki Update on: + push: + branches: [main] pull_request: - types: [opened, synchronize, reopened] + workflow_dispatch: permissions: - actions: write - contents: write - pull-requests: read - -concurrency: - group: fast-forward-wiki-preview-${{ github.event.pull_request.number || github.ref }} - cancel-in-progress: true + contents: write # Ceiling for the isolated publisher; generation remains read-only. jobs: - preview: - permissions: - actions: write - contents: write - pull-requests: read - # Pull-request wiki previews live here. Publication and preview cleanup are - # handled by the separate wiki-maintenance wrapper. - uses: php-fast-forward/dev-tools/.github/workflows/wiki-preview.yml@main - secrets: inherit + wiki: + uses: php-fast-forward/dev-tools/.github/workflows/wiki-direct.yml@c44339acd9b09b1a7f2249cceb8928e5e93cf42b # dev-tools#366 diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 9e1746a..0000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule ".github/wiki"] - path = .github/wiki - url = https://github.com/php-fast-forward/enum.wiki.git diff --git a/AGENTS.md b/AGENTS.md index 3a22574..fb8342f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -86,7 +86,7 @@ Important paths: - `tests/Support/` enum fixtures used across tests - `README.md` package onboarding and usage examples - `docs/` Sphinx documentation for installation, quickstart, usage, API references, and advanced integration notes -- `.github/wiki/` generated wiki content used by wiki workflows +- `.dev-tools/wiki-generated/` local generated Markdown; `wiki.yml` publishes it to the separate Wiki repository without a submodule - `.agents/agents/` packaged role prompts for repository-specific delegation - `.agents/skills/` procedural skills used by the packaged agents - `.github/workflows/` CI workflows managed by `dev-tools` @@ -143,7 +143,7 @@ Prefer onboarding-friendly examples for new users. Show practical enum calls ins Use `README.md` as the canonical short-form package guide and expand from there into Sphinx docs rather than duplicating content blindly. For new-user documentation, explain what each helper or enum catalog solves, then show the smallest useful example. -When wiki output is part of the task, update `.github/wiki/` through the supported `dev-tools` wiki command instead of hand-editing generated pages. +When wiki output is part of the task, use `dev-tools wiki --target=.dev-tools/wiki-generated` instead of hand-editing generated pages. Do not initialize a Wiki submodule during normal maintenance. ## Collaboration Notes diff --git a/CHANGELOG.md b/CHANGELOG.md index 9f090a4..1338565 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Changed +- Publish generated Wiki pages directly without tracking the Wiki as a Git submodule. + - Replace the mascot banner with contextual Dash artwork for typed enum cases and align README and documentation references. (#5) ### Fixed