[changelog] Align consumer docs and workflow invocation (#28)

Author: coisa

.github/workflows/changelog.yml

@@ -108,7 +108,7 @@ jobs:
             - name: Verify changelog update
               env:
                   BASE_REF: ${{ github.event.pull_request.base.ref }}
-              run: vendor/bin/dev-tools changelog:check --file="${CHANGELOG_FILE}" --against="origin/${BASE_REF}"
+              run: composer dev-tools changelog:check -- --file="${CHANGELOG_FILE}" --against="origin/${BASE_REF}"
 
     prepare_release_pull_request:
         name: Prepare Release Pull Request
@@ -160,7 +160,7 @@ jobs:
                     version="${INPUT_VERSION}"
                     source="input"
                   else
-                    version="$(vendor/bin/dev-tools changelog:next-version --file="${CHANGELOG_FILE}")"
+                    version="$(composer dev-tools changelog:next-version -- --file="${CHANGELOG_FILE}")"
                     source="inferred"
                   fi
 
@@ -172,14 +172,14 @@ jobs:
                   RELEASE_VERSION: ${{ steps.version.outputs.value }}
               run: |
                   release_date="$(date -u +%F)"
-                  vendor/bin/dev-tools changelog:promote "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" --date="${release_date}"
+                  composer dev-tools changelog:promote -- "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" --date="${release_date}"
 
             - name: Render release notes preview
               env:
                   RELEASE_VERSION: ${{ steps.version.outputs.value }}
               run: |
                   mkdir -p .dev-tools
-                  vendor/bin/dev-tools changelog:show "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" > .dev-tools/release-notes.md
+                  composer dev-tools changelog:show -- "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" > .dev-tools/release-notes.md
 
             - name: Create release preparation pull request
               id: create_pr
@@ -269,7 +269,7 @@ jobs:
                   RELEASE_VERSION: ${{ steps.version.outputs.value }}
               run: |
                   mkdir -p .dev-tools
-                  vendor/bin/dev-tools changelog:show "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" > .dev-tools/release-notes.md
+                  composer dev-tools changelog:show -- "${RELEASE_VERSION}" --file="${CHANGELOG_FILE}" > .dev-tools/release-notes.md
 
             - name: Publish GitHub release
               env:

docs/usage/github-actions.rst

@@ -91,18 +91,18 @@ wrapper in ``resources/github-actions/changelog.yml``.
     *   Uses ``fetch-depth: 0`` so the base branch reference can be compared
         safely.
     *   Fetches the base branch changelog reference.
-    *   Runs ``vendor/bin/dev-tools changelog:check`` against the base ref.
+    *   Runs ``composer dev-tools changelog:check -- --against=<base-ref>`` against the base ref.
     *   Fails when the current branch does not add a meaningful ``Unreleased`` change.
 *   **Manual Release Preparation**:
     *   Checks out the repository default branch with full history.
     *   Resolves the next version from ``Unreleased`` unless a version input is provided.
     *   Promotes ``Unreleased`` into the selected version with the current UTC release date.
     *   Writes a release-notes preview file to ``.dev-tools/release-notes.md`` with
-        ``vendor/bin/dev-tools changelog:show``.
+        ``composer dev-tools changelog:show -- <version>``.
     *   Opens or updates a release-preparation pull request instead of committing directly to ``main``.
 *   **Merged Release Pull Requests**:
     *   Detects merged branches that match the configured release branch prefix.
-    *   Renders the released changelog section with ``vendor/bin/dev-tools changelog:show``.
+    *   Renders the released changelog section with ``composer dev-tools changelog:show -- <version>``.
     *   Creates or updates the Git tag and GitHub release with the rendered changelog section as the release body.
 
 **Inputs:**