Skip to content

Read the build from store/ when the old default path is empty - #15

Merged
bonelifer merged 2 commits into
mainfrom
docs-path-fallback
Oct 7, 2026
Merged

bonelifer merged 2 commits into
mainfrom
docs-path-fallback

Conversation

@bonelifer

Copy link
Copy Markdown
Contributor

Boards set to the old default build path, ext/phpbbmodders/documentation/docs-build, keep it after upgrading when a build was there at the time (migration m7_store_docs_path). If that build is later moved to store/phpbbmodders_documentation without updating the setting, the extension reported that no build was found.

  • Fallback: when the setting is still the old default and that directory has no build, but store/phpbbmodders_documentation has one, the extension reads the build from store/. Any other path is used exactly as configured.
  • ACP notices: the settings page says when the fallback is in use, so the setting can be updated, and when the build in use is inside the extension's own directory, where the next extension update would delete it.
  • README: the upgrade note mentions both.

Testing
Claude added tests for the fallback and both notices (132 tests), which pass in Docker on PHP 8.2 and 8.4. On a 3.3.19 test board, Claude reproduced a board still set to the old path with its build moved to store/: the documentation loads and the fallback notice shows. With the build inside the extension, only the in-extension notice shows. The phpbb-release-tools feature checks pass.


Investigated and written by Claude on behalf of William Jacoby (bonelifer).

bonelifer and others added 2 commits October 7, 2026 09:09
Boards set to the old default, ext/phpbbmodders/documentation/docs-build,
keep it when a build was there at upgrade time. If that build is later
moved to store/phpbbmodders_documentation without updating the setting,
the extension now reads it from there instead of reporting no build.

The ACP settings page says when this fallback is in use, and when the
build in use is inside the extension's own directory, where the next
extension update would delete it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@bonelifer
bonelifer requested a review from kaileymsnay October 7, 2026 14:10
@bonelifer
bonelifer merged commit 6403ead into main Oct 7, 2026
7 checks passed
@bonelifer
bonelifer deleted the docs-path-fallback branch October 7, 2026 14:14
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