chore(sync): retire the upstream mirror and author content in-repo - #61
Merged
Conversation
Delete .github/workflows/sync-upstream.yml. Documentation is no longer mirrored from the legacy owncloud/docs-* repos; content/<product>/<version>/ is authored directly in this repo, so modules/ becomes hand-editable and a PR against main is the only path for content changes. sync/ is kept as provenance -- manifest.yml records which upstream repo and branch each version folder was last imported from, which is what you need to compare a folder against its legacy origin. sync-repo.sh gains a retirement guard: the mirror is destructive (rm -rf + cp -a per sync_paths entry), so a stray invocation would silently discard every in-repo edit since the cutover. It now refuses unless SYNC_UPSTREAM_I_KNOW_THIS_IS_RETIRED=1 is set. The two post-sync patches (docs-webui, docs-main) are already materialised in the tracked content, so the corrected xrefs are permanent and need no re-application; their README notes are kept to record which divergences from upstream were deliberate. README: invert the "do not hand-edit modules/" warning, drop the manifest bookkeeping step from "Dropping a version" and the manifest repointing from the release-rollover note, and mark the branch references in the versions table as historical. Note that this stops mirroring for all seven products, not just ocis -- main, server, webui, desktop, ios and android content freezes at its current state. That is the intended behaviour of issue #44 Phase 5. Refs: #44 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
chore/retire-upstream-sync
branch
from
August 20, 2026 08:08
4461217 to
ee46ac6
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.
Executes the first bullet of Phase 5 in #44:
What changes
.github/workflows/sync-upstream.yml. Nothing mirrors the legacyowncloud/docs-*repos into this repo any more.sync/retired, not removed.sync/manifest.ymlkeeps the branch→folder mapping as provenance: it records which upstream repo and branch each version folder was last imported from, which is exactly what you need to diff a folder against its legacy origin.sync/sync-repo.shgains a retirement guard. The mirror is destructive —rm -rf+cp -apersync_pathsentry — so a stray invocation would silently discard every in-repo edit made since the cutover. It now refuses unlessSYNC_UPSTREAM_I_KNOW_THIS_IS_RETIRED=1is set.sync/patches/README.mdnotes the two patches (docs-webui.sh,docs-main.sh) are already materialised in the tracked content, so the corrected xrefs are permanent and need no re-application. Verified incontent/webui/modules/ROOT/pages/index.adoc,content/main/modules/ROOT/partials/nav.adocandcontent/main/modules/ROOT/pages/server_releases.adoc.README.md— the "modules/" warning is inverted:modules/is now authored here. Also drops thesync/manifest.ymlbookkeeping step from Dropping a version, drops the manifest repointing from the release-rollover note, and marks the branch references in the Versions imported table as historical.Consequence worth stating explicitly
This stops mirroring for all seven products, not just ocis.
main,server,webui,desktop,iosandandroidcontent freezes at its current state; any future commit in those upstream repos will no longer reach this repo. Those repos have no open issues, so nothing is being dropped on the floor — but authoring for them now has to happen here too.Follow-ups in flight
Two draft PRs port the unmerged ocis content that this cutover unblocks (
owncloud/docs-ocis#1286and#1285— neither ever merged upstream, so no version folder carries their content). They depend on this PR landing first, otherwise a sync run would wipe the hand-editedmodules/.Verification
bash sync/sync-repo.sh docs-ocis→ refuses, exit 1.grep -n sync README.md→ only the three retired/historical references remain.npm testare unaffected.Refs: #44