docs: move next to 11.0 and require explicit docker image versions - #1575
docs: move next to 11.0 and require explicit docker image versions#1575DeepDiver1975 wants to merge 3 commits into
Conversation
ownCloud Classic 11.0.0 is released, so master no longer documents an unreleased version. Rename the component version from `next` to `11.0` and drop the `prerelease` key, which makes Antora pick this branch as the component's `latest` and removes the `next` version segment. This also fixes the version display on the docker installation page. The `.env` example interpolates `latest-server-download-version`, which was pinned to the 10.16 line, so the future-11 page told admins to run a 10.16.4 image. The local build attributes in `site.yml` and `global-attributes.yml` now name 11.0 / 11.0.0 accordingly. Every documented image reference now carries an explicit version tag and the `latest` tag is no longer recommended anywhere: `owncloud/server:latest` tracks the 10.16 line rather than the newest release, and no rolling major or minor tag exists at all, so following it from the 11 docs silently installs 10.16.4. This covers the untagged quick-evaluation `docker run`, the `OWNCLOUD_IMAGE` setting description, the commented-out memcached service and the selenium and inbucket images in the UI testing guide. Three defects found while verifying the documented commands against the published `owncloud/server:11.0.0` image: * The `.env` example omitted `ADMIN_USERNAME` and `ADMIN_PASSWORD` although the compose file maps both into the container and the settings table lists them as required, so a verbatim copy produced a blank admin account. * `mysql_upgrade` was documented against the `owncloud` service, but the binary ships with the database image and only exists in `mariadb`. * The ImageMagick command-line tools are not part of the image, so the preview prerequisite checks cannot succeed as written. The page now points at the guide for building your own image. Finally, adjust the version-branch procedure to the new model, where master carries the released version instead of `next`, and replace its stale `.drone.star` instructions with the CI workflow branch list that actually governs which branches get built. Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
Four pages that exist in 10.16 have no equivalent here, so their URLs start 404ing the moment this branch becomes the `latest` server version: `installation/index.adoc` and `installation/source_installation.adoc` (this is a docker-only release, so there is no manual or source installation), `installation/configuration_notes_and_tips.adoc` (now `configuration/important_notes.adoc`) and `maintenance/migrating.adoc` (now under `maintenance/migrate_owncloud/`). These are not merely stale internal links. All four are `go.php` redirect keys (`admin-install`, `admin-source_install`, `admin-php-fpm`, `admin-untrusted-domains`) that every deployed ownCloud server emits via `buildDocLinkToKey`, and `owncloud/docs` asserts in CI that every mapped target exists in the built site. Aliasing them keeps those links working and keeps the docs build green, which a mapping change would not. Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
|
Added a second commit ( Four pages that exist in 10.16 have no equivalent here, so their URLs would start 404ing the moment this becomes the latest server version: These are not just stale internal links — all four are Verified in a full aggregated build: all four legacy paths now emit redirect stubs to the new pages, 0 build errors, and |
The explicit-version requirement is about `owncloud/server` only: its `latest` tag does not track the newest ownCloud Classic release and there are no rolling major or minor tags, so following it from the 11 docs installs a version the docs do not describe. That reasoning does not carry over to the third-party images. Pinning the commented-out memcached service in the compose example and the selenium and inbucket images in the UI testing guide fixes no documented-version mismatch and only adds pins that nothing in this repo keeps current, so restore them to their previous form. The two `standalone-chrome*` pins stay, they predate this and exist because of owncloud/core#35444. Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
ownCloud Classic 11.0.0 is released, so master no longer documents an unreleased version.
Version move
antora.yml:version: next->version: '11.0',prerelease: truedropped. Antora picks the newest non-prerelease version of a component as itslatest, so this branch becomes/server/latest/and thenextsegment disappears.11.0branch is cut and no newnextis created.minimum-php-printed/recommended-php-versionwere still on 8.1.core@v11.0.0lib/base.phprefusesPHP_VERSION_ID < 80300and refuses>= 80600, and the image ships PHP 8.3.6, so both move to 8.3.Needs the companion PR in
owncloud/docsto land right after this one, which drops'10.15'from the docs-server content sources, moves the server-versionattributes and updatesPUBLISHED_VERSIONSingo-redirect.js.Version display fix
The docker installation page rendered
OWNCLOUD_IMAGE=10.16.4on the future-11 docs. The.envexample interpolateslatest-server-download-version, and the value that wins comes from the aggregating playbook, which was pinned to the 10.16 line. The local build attributes insite.ymlandglobal-attributes.ymlnow name 11.0 / 11.0.0.No more
:latestowncloud/server:latestis 10.16.4, not 11.0.0, and there is no rolling11.0or11tag at all, so a reader followinglatestfrom the 11 docs silently installs 10.16.4. Every documentedowncloud/serverreference now carries an explicit version tag:docker runOWNCLOUD_IMAGEsetting description, which recommendedlatestas an alternativeThis applies to
owncloud/serveronly. An earlier revision of this PR also pinned the third-party images (the commented-outmemcachedservice in the compose example, the selenium and inbucket images in the UI testing guide); those pins are reverted, since they fix no documented-version mismatch and nothing in this repo keeps them current.Defects found while verifying against the published image
I ran the documented flows against
owncloud/server:11.0.0(both the quick-eval container and this repo's own compose example). The stack came up healthy -status.phpreports versionstring 11.0.0,integrity:check-coreis INTACT - anddocker compose exec owncloud occ ...,docker exec --user www-data oc-eval occ ..., the two/bin/bashvariants anddocker compose run --rm ... /usr/bin/owncloud bashall work as documented. Three things did not:.envexample omittedADMIN_USERNAMEandADMIN_PASSWORD, although the compose file maps both into the container and the settings table lists them as required.docker compose configon the verbatim files warns"ADMIN_USERNAME" variable is not setand emitsOWNCLOUD_ADMIN_USERNAME: "", so a copy/paste install got a blank admin account.mysql_upgradewas documented against theowncloudservice. The binary ships with the database image and only exists inmariadb.create_own_image.adocalready lists preview configuration as a reason to build your own image, but nothing linked back; that link is now there.Process doc
docs/new-version-branch.mdassumed master always carries an unreleasednext, and instructed edits to.drone.star, which no longer exists in this repo. Both are corrected, naming the CI workflow branch list as the real control.Testing
npm run antora-localproduces the same two pre-existingocis:cross-component xref errors as master and no new ones. In the built output: the version segment is11.0, the page rendersOWNCLOUD_IMAGE=11.0.0andowncloud/server:11.0.0, the admin credentials are present, and noor latestremains.🤖 Generated with Claude Code