Skip to content

docs: normalize legacy server product name to "ownCloud Classic" (10.15)#1552

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

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

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.15 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.15' are untouched (xref component IDs and version routing 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. ✅

Note: migrating_to_ocis.adoc on this branch carries some pre-existing surrounding typos (e.g. "oCis", "extrernal", an absolute /ocis/next/ link) — these are unrelated to this PR and were not introduced by it; the rename edits themselves are correct and prose-only.

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

No blocking issues.

: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.

{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.

== 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.

== 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

=== 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.

…eptance docs

Apply review feedback (#1552): where 'ownCloud Classic 10' denotes the
product as the migration source or in a generic guide context, the '10'
is redundant now that the product is named ownCloud Classic. Strip it in
the migration-to-oCIS guide and the acceptance-tests intro.

Meaningful version references are kept unchanged: 'Starting with ownCloud
Classic 10' (database), the theming 'before/deprecated in 10' and
'upcoming ownCloud Classic 11' contrast, the WND listener, and the
migration 10 -> 11 steps.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
DeepDiver1975 added a commit that referenced this pull request Jun 23, 2026
…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

Copy link
Copy Markdown
Member Author

Thanks @phil-davis — applied all 5 suggestions in ce1a2a2.

You've identified the right distinction: in these spots ownCloud Classic 10 denotes the product as the migration source / generic context, so the 10 is redundant now. I've stripped it in the migration-to-oCIS guide and the acceptance-tests intro, while keeping the genuinely version-specific references untouched (Starting with ownCloud Classic 10 in the database doc, the theming before/deprecated in 10 + upcoming ownCloud Classic 11 contrast, the WND listener, and the migration 10 → 11 steps).

For consistency I've applied the same change on the other branches carrying these lines:

@DeepDiver1975 DeepDiver1975 requested a review from phil-davis June 23, 2026 14:22

@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.15 branch.

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.15' 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[...]) — only the bracketed display text / surrounding prose changed.
  • image::/include:: changes are inside the [...] alt-text/title only (e.g. include::example$installation/docker/docker-compose.yml[...], image::.../collabora-online-administration.png[...]) — file/resource targets unchanged.
  • URLs untouched (server_release_notes.html#..., the github.com/owncloud/core/.../SettingsManager.php#L195 link, registry.owncloud.com, etc.).
  • :page-aliases: (maintenance/upgrade.adoc, ...), :description: attribute values (prose), nav.adoc list label ("ownCloud Classic UI" — display only; the xref: entries below it unchanged), and the README #create-a-new-version-branch-for-owncloud-server 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 (this also covers the migrating_to_ocis.adoc "OC10"/"ownCloud 10" → "ownCloud Classic" prose tidy-up).

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. (Not approving/merging here per process; this is a review comment only.)

phil-davis pushed a commit that referenced this pull request Jun 23, 2026
…eptance docs (#1553)

Follow-up to the rename: where 'ownCloud Classic 10' denotes the product
as the migration source or in a generic guide context, the '10' is
redundant now that the product is named ownCloud Classic. Strip it in
the migration-to-oCIS guide and the acceptance-tests intro.

Meaningful version references are intentionally kept: 'Starting with
ownCloud Classic 10' (database), the theming 'before/deprecated in 10'
and 'upcoming ownCloud Classic 11' contrast, the WND listener, and the
migration 10 -> 11 steps.

Raised from review feedback on the 10.15 backport (#1552).

Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@phil-davis phil-davis merged commit 4c6aee9 into 10.15 Jun 23, 2026
2 checks passed
@phil-davis phil-davis deleted the docs/backport-owncloud-classic-10.15 branch June 23, 2026 14:55
phil-davis pushed a commit that referenced this pull request Jun 23, 2026
…16) (#1551)

* docs: normalize legacy server product name to "ownCloud Classic"

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>

* docs: drop redundant '10' from 'ownCloud Classic 10' in migration/acceptance 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>

---------

Signed-off-by: Thomas Müller <1005065+DeepDiver1975@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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