docs(ocis): add 8.1 updates — vault mode, blobstore CLI, 8.0→8.1 upgrade guide - #62
Draft
DeepDiver1975 wants to merge 1 commit into
Draft
docs(ocis): add 8.1 updates — vault mode, blobstore CLI, 8.0→8.1 upgrade guide#62DeepDiver1975 wants to merge 1 commit into
DeepDiver1975 wants to merge 1 commit into
Conversation
This was referenced Aug 20, 2026
DeepDiver1975
force-pushed
the
chore/retire-upstream-sync
branch
from
August 20, 2026 08:08
4461217 to
ee46ac6
Compare
DeepDiver1975
force-pushed
the
docs/ocis-8.1-updates
branch
from
August 20, 2026 08:09
4b564dd to
08784c3
Compare
…grade guide Port of owncloud/docs-ocis#1286, which never merged upstream -- so ocis 8.1 and 8.2 shipped without this content and no version folder here carries it. Applied to content/ocis/8.1, 8.2 and 8.3 (substantive content, per the README backport rule -- a feature present since 8.1 is documented in every version that has it): * storage-users "Vault Mode" service configuration section * ports-used: the 9285-9289 storage-users (vault) range * new "Verify and Inspect a Blobstore" command page + its index entry * new maintenance/ocis-storage-users-cli.adoc partial * new "Upgrading from 8.0.0 to 8.1.0" guide + its upgrading-ocis entry Applied to content/ocis/8.1 only (version bookkeeping -- these pages describe one specific version delta, so the rewrite belongs in the folder whose delta it is): * changed-cli.adoc: 8.0.0 -> 8.1.0 delta * env-var-changes.adoc: 8.0.0 -> 8.1.0 delta Dropped from the port: the upstream antora.yml hunk. antora.yml is monorepo-owned and never was synced; each folder already carries the correct per-version values. Corrected while porting: "There are ne breaking changes" -> "no", and the trailing space on the added ports-used row. Refs: owncloud/docs-ocis#1286 Refs: owncloud/docs-ocis#1259 Refs: owncloud/docs-ocis#1287 Co-Authored-By: Martin Mattel <github@diemattels.at> Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com> Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
DeepDiver1975
force-pushed
the
docs/ocis-8.1-updates
branch
from
August 20, 2026 09:07
08784c3 to
e454d54
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Port of
owncloud/docs-ocis#1286("docs: updates required for 8.1", by @mmattel) into the monorepo.That PR never merged upstream, so ocis 8.1 and 8.2 shipped without this content and no version folder here carries it. Verified before porting:
verify-and-inspect-blobstore.adoc,upgrading_8.0.0_8.1.0.adocand the vault section are absent from everycontent/ocis/*folder.Note
Retargeted to
main. #61 (retire the upstream mirror) has merged, somodules/is now hand-editable and this PR no longer needs a chained base. The branch was rebased ontomain; the tree is byte-identical to the reviewed-and-verified version, only the parent commit changed.Where the changes land
Per the README backport rule, a feature present since 8.1 is documented in every version that has it, while pages that describe one specific version delta are only touched in the folder whose delta they are.
Substantive content →
content/ocis/8.1,8.2and8.3:== Vault Modeservice configuration (+61)admin/pages/deployment/services/s-list/storage-users.adoc9285-9289storage-users (vault) port rangeadmin/pages/deployment/services/ports-used.adocadmin/pages/maintenance/commands/verify-and-inspect-blobstore.adocadmin/pages/maintenance/commands/commands.adocadmin/partials/maintenance/ocis-storage-users-cli.adocadmin/pages/migration/upgrading_8.0.0_8.1.0.adocadmin/pages/migration/upgrading-ocis.adocVersion bookkeeping →
content/ocis/8.1only::description:→ 8.0.0 → 8.1.0 delta, and the delta bullet listadmin/pages/maintenance/commands/changed-cli.adoc:description:→ 8.0.0 → 8.1.0 delta, maintainer block →docs-stable-8.1/8.0.0-8.1.0admin/pages/deployment/services/env-var-changes.adocCopying those two into 8.2/8.3 would make them claim to describe the 8.0→8.1 delta, which is wrong for those versions. This also avoids a collision with the companion 8.2 port, which rewrites the same
changed-cli.adoc.Dropped from the port
antora.yml— the upstream PR retargets it fromnextto8.1.antora.ymlis monorepo-owned (it was never insync_paths) and every folder already carries correct per-version values:content/ocis/8.1/antora.ymlhasenv_var_delta_name: '8.0.0-8.1.0',service_url_component: 'docs-stable-8.1',ocis_repo_url_stable: 'stable-8.1'.Corrected while porting
upgrading-ocis.adoc: "There are ne breaking changes in Infinite Scale 8.1" → "no".ports-used.adocrow.❓ Open review question — please confirm before this leaves draft
The vault intro sentence ends mid-word upstream and is carried over verbatim rather than guessed at:
content/ocis/*/modules/admin/pages/deployment/services/s-list/storage-users.adoc:338. @mmattel — is the intended ending "explicitly disallowed."?Verification
npm run antora→ exit 0, no warnings or errors mentioning the new pages, the new partial, or the new xref targets. The 28target of xref not found: next@ocis:…errors are pre-existing incontent/main/modules/ROOT/pages/ocis_release_notes.adoc, which this branch does not touch.npm test→ 17/17 pass.ocis-storage-users-clipartial resolves (noUnresolved directivemarkers anywhere underpublic/ocis/8.{1,2,3}/admin).changed-cli.htmlreads 8.0.0 and 8.1.0 in 8.1 and is unchanged (7.3.0 and 8.0.0) in 8.2/8.3, as intended.antora.ymland nocontent/ocis/{7.3,8.0}paths in the diff.Refs:
owncloud/docs-ocis#1286.Addresses the two upstream issues this content was written for, now migrated into this repo: #84 (
owncloud/docs-ocis#1259) and #88 (owncloud/docs-ocis#1287).Refs #44