Skip to content

docs: normalize legacy server product name to "ownCloud Classic" (10.16)#1551

Merged
phil-davis merged 2 commits into
10.16from
docs/backport-owncloud-classic-10.16
Jun 23, 2026
Merged

docs: normalize legacy server product name to "ownCloud Classic" (10.16)#1551
phil-davis merged 2 commits into
10.16from
docs/backport-owncloud-classic-10.16

Conversation

@DeepDiver1975

Copy link
Copy Markdown
Member

What

Normalizes the legacy ownCloud server product to its canonical name ownCloud Classic across all user-facing documentation in this repo. Version (10/11) is retained only as trailing information where relevant (e.g. "ownCloud Classic 10").

Normalized: ownCloud Server, ownCloud Classic Server, bare ownCloud 10/11, and the OC10 prose shorthand used throughout the migration guide. The Antora component title is updated from ownCloud Server to ownCloud Classic.

Why

Part of owncloud/docs#5111 — a coordinated, docs-only rebranding so the legacy product is consistently named ownCloud Classic across the owncloud / owncloud-docker orgs. Reference implementation: owncloud/docs-main#187.

Out of scope (intentionally untouched)

  • xref:/include:: targets, module slugs (classic_ui, oc10-app), URLs, hostnames (oc10-telemetry, oc10130b1…), anchors
  • AsciiDoc editorial comments (e.g. // this needs review for oc10 -> oc11)
  • The new product names: ownCloud Infinite Scale / oCIS
  • The component name: server slug (only the display title changed)

Known follow-up

The product name is still embedded in one Kerberos diagram source (modules/admin_manual/images/.../kerberos-principle.drawio.svg). Updating diagram artwork requires re-rendering and is intentionally left out of this text-only PR.

Verification

  • All target variants normalized in prose/headings/title; only display text changed.
  • Every xref/include/URL target byte-for-byte identical before/after.
  • oCIS / Infinite Scale occurrence count unchanged.
  • Standalone Antora build produces an identical error set vs master (2 pre-existing cross-component ocis: xrefs that only resolve in the aggregate build) — no new errors.
  • No internal xref depends on the 13 headings whose auto-generated anchors change.

Reviewer checklist

  • No xref targets / module slugs / URLs / hostnames altered
  • oCIS / Infinite Scale untouched
  • Version shown only as additional info ("ownCloud Classic 10")

🤖 Generated with Claude Code

Backport of the "ownCloud Classic" rename to this maintained version
branch so the published docs are consistent across versions.

Renames the legacy product to its canonical name "ownCloud Classic"
in user-facing text (prose, headings, link display text, the Antora
component title), fixes grammar where replacing the noun "Server"
left a dangling phrase, and normalizes the OC10 prose shorthand in
the migration guide.

Out of scope / unchanged: xref/include targets, module slugs
(classic_ui, oc10-app), URLs, hostnames, attribute names, and the
new product names (ownCloud Infinite Scale / oCIS). Version numbers
in this version-specific manual are kept (e.g. migration 10 -> 11).

Verified: every URL/xref target byte-identical, oCIS/Infinite Scale
occurrences unchanged, and the Antora build produces an identical
error set versus the base branch.

Part of owncloud/docs#5111

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>

@DeepDiver1975 DeepDiver1975 left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Automated review by Claude Code review agent.

Verdict: LGTM — clean, prose-only product-name normalization ("ownCloud Server" → "ownCloud Classic") backported to the 10.16 branch.

Checked the full diff (39 files) for any non-display-text changes and found none:

  • antora.yml — only title: changed; the component name: server and version: 10.16 are untouched (so xref component IDs and version routing are unaffected). ✅
  • README.md — link/heading display text updated to "Classic" while the anchor target #create-a-new-version-branch-for-owncloud-server is correctly left intact. ✅
  • All xref: / image: / include:: targets, file paths, :page-aliases:, URLs, attribute names (e.g. :description:), marketplace-URL attributes, and code literals (config.php, oc_filecache, env vars, occ command names) — unchanged. Only human-readable text was altered. ✅

Required checks (Build documentation, lint) are green. No changelog in this repo (n-a).

No blocking issues.

== Overview

The migration works with an app to be installed on the ownCloud 10 side. The app is provided by ownCloud as part of the guided migration. Please contact {oc-support-url}[ownCloud support] to get it.
The migration works with an app to be installed on the ownCloud Classic 10 side. The app is provided by ownCloud as part of the guided migration. Please contact {oc-support-url}[ownCloud support] to get it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The migration works with an app to be installed on the ownCloud Classic 10 side. The app is provided by ownCloud as part of the guided migration. Please contact {oc-support-url}[ownCloud support] to get it.
The migration works with an app to be installed on the ownCloud Classic side. The app is provided by ownCloud as part of the guided migration. Please contact {oc-support-url}[ownCloud support] to get it.

Migrate to oCIS should still work from ownCloud Classic 11?

=== Preparing to Run Acceptance Tests

This is a concise guide to running acceptance tests on ownCloud 10.
This is a concise guide to running acceptance tests on ownCloud Classic 10.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This is a concise guide to running acceptance tests on ownCloud Classic 10.
This is a concise guide to running acceptance tests on ownCloud Classic.

Hmmm - this is for the 10.16 specific manual, so maybe don't have to remove "10" here.
But the instructions should work for OwnCloud Classic 11 (I have followed them at times to run acceptance tests locally with current core master)

{description}

The migration transfers users, groups, files, and shares from an ownCloud 10 (OC10) instance to a target oCIS instance in a series of sequential steps. The OC10 server is not modified by the migration — it remains operational throughout most of the process.
The migration transfers users, groups, files, and shares from an ownCloud Classic 10 instance to a target oCIS instance in a series of sequential steps. The ownCloud Classic server is not modified by the migration — it remains operational throughout most of the process.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The migration transfers users, groups, files, and shares from an ownCloud Classic 10 instance to a target oCIS instance in a series of sequential steps. The ownCloud Classic server is not modified by the migration — it remains operational throughout most of the process.
The migration transfers users, groups, files, and shares from an ownCloud Classic instance to a target oCIS instance in a series of sequential steps. The ownCloud Classic server is not modified by the migration — it remains operational throughout most of the process.

== Prerequisites

=== ownCloud 10
=== ownCloud Classic 10

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
=== ownCloud Classic 10
=== ownCloud Classic

:toc: right
:toclevels: 3
:description: This guide describes how to migrate an ownCloud 10 instance to ownCloud Infinite Scale (oCIS) using the migrate-to-ocis app and its occ commands.
:description: This guide describes how to migrate an ownCloud Classic 10 instance to ownCloud Infinite Scale (oCIS) using the migrate-to-ocis app and its occ commands.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:description: This guide describes how to migrate an ownCloud Classic 10 instance to ownCloud Infinite Scale (oCIS) using the migrate-to-ocis app and its occ commands.
:description: This guide describes how to migrate an ownCloud Classic instance to ownCloud Infinite Scale (oCIS) using the migrate-to-ocis app and its occ commands.

…eptance docs

Apply review feedback (mirrors #1552): strip the redundant '10' where
'ownCloud Classic 10' denotes the product as migration source / generic
context, in the migration-to-oCIS guide and acceptance-tests intro.
Meaningful version references (database 'Starting with', theming
'before/upcoming 11', WND, migration 10 -> 11) are kept.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>

@DeepDiver1975 DeepDiver1975 left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Automated review by Claude Code review agent.

Re-reviewed after the substantial growth from 7 files to 50 files (108+/108-). This is the "ownCloud Server" → "ownCloud Classic" product-name normalization now applied across the full content tree for the 10.16 branch (the sibling of #1552 on 10.15).

Because a 50-file rename has real risk of catching non-prose targets, I verified every changed hunk specifically for that. Findings:

Clean — only display text / prose / headings changed. No non-prose target was altered:

  • antora.yml: only title: changed; the component name: server and version: 10.16 are untouched (correct — name/version are the structural identifiers).
  • All xref: targets preserved verbatim (e.g. xref:configuration/server/config_apps_sample_php_parameters.adoc#app-openid-connect-oidc[...], xref:classic_ui:index.adoc[...], xref:#migrate-files-and-shares[...]) — only the bracketed display text / surrounding prose changed.
  • image::/include:: changes are inside the [...] alt-text/title only — file/resource targets unchanged.
  • URLs untouched (server_release_notes.html#..., github.com/owncloud/core/.../SettingsManager.php#L195, registry.owncloud.com, etc.).
  • :page-aliases:, :description: attribute values (prose), nav.adoc list label, and the README anchor target all preserved.
  • No code/command/config literal was changed: METRICSAPIKEY, owncloud/server, OCIS_SHARING_PUBLIC_SHARE_MUST_HAVE_PASSWORD, migrate:to-ocis:* occ commands, config.php keys, etc. all intact — only the prose around them was normalized (incl. the migrating_to_ocis.adoc "OC10"/"ownCloud 10" → "ownCloud Classic" prose tidy-up; note this file's prose differs slightly from the 10.15 variant, as expected per branch).

Checks: Build documentation = pass, lint = pass. The Antora build is the authoritative xref/include guard for a 50-file change, and it is green — strong confirmation no reference was broken.

CHANGELOG: n-a (this repo has no changelog).

LGTM — a clean, consistent docs-only normalization, matching #1552 on the 10.16 branch. (Not approving/merging here per process; this is a review comment only.)

@phil-davis phil-davis merged commit 7f8a7d4 into 10.16 Jun 23, 2026
2 checks passed
@phil-davis phil-davis deleted the docs/backport-owncloud-classic-10.16 branch June 23, 2026 14:55
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.

2 participants