Skip to content

API docs aren't updating with patch release #19570

Open

Description

@othercorey

Description

The API docs for 5.4 don't seem to be updating with patch releases.

https://api.cakephp.org/5.4/class-Cake.Database.FunctionsBuilder.html#concat()

76afad4

CakePHP Version

5.4

PHP Version

No response

Activity

  1. added theissue type on Jul 30, 2026
  2. self-assigned this
    on Jul 30, 2026
  3. markstory commented on Aug 3, 2026

    @markstory
    Member

    The 5.4.1 tag did trigger a build of the API docs correctly https://github.com/cakephp/cakephp-api-docs/actions/runs/30417845070.

    It looks like the push to dokku was a no-op though as I don't see any build logs that a rebuild would create. I've tried enabling force pushes from GitHub actions. That might help with getting rebuilds each time the workflow runs. If that doesn't help, I can rework the action to include generated content on each action run so that there are changes on each workflow run.

  4. othercorey commented on Aug 3, 2026

    @othercorey
    ContributorAuthor

    It looks like the push to dokku was a no-op though as I don't see any build logs that a rebuild would create. I've tried enabling force pushes from GitHub actions. That might help with getting rebuilds each time the workflow runs. If that doesn't help, I can rework the action to include generated content on each action run so that there are changes on each workflow run.

    Unless there is a change, I'm not sure force push will trigger a dokku build because it can still be up to date.

  5. LordSimal commented on Aug 3, 2026

    @LordSimal
    Member

    I forced a rebuild manually now.

  6. othercorey commented on Aug 3, 2026

    @othercorey
    ContributorAuthor

    I think the only other solution is running a remote ssh dokku build command.

  7. yohimik commented on Sep 9, 2026

    @yohimik

    The current deployment workflow still checks out 2.x and force-pushes it to Dokku. In this incident, the release-triggered workflow completed but the Dokku push was a no-op, and a maintainer later forced the rebuild manually. That supports a specific recovery gap: when the requested CakePHP release changes but the docs repository does not, a successful push does not establish that a new docs build ran.

    I could not independently verify the currently served API revision because my unauthenticated request received HTTP 403. The evidence here is limited to the workflow source and the manual-recovery record in this thread.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions