From a39fbfd815adfc623f9c77879077e78a3b4a1069 Mon Sep 17 00:00:00 2001
From: Maarten de Waard <maarten@greenhost.nl>
Date: Thu, 16 Dec 2021 10:58:18 +0100
Subject: [PATCH] update NC transfer instructions

---
 docs/upgrading.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/upgrading.rst b/docs/upgrading.rst
index 9155d7690..fed8c7e95 100644
--- a/docs/upgrading.rst
+++ b/docs/upgrading.rst
@@ -75,12 +75,17 @@ Nextcloud
 ~~~~~~~~~
 
 Your SSO users will have new usernames, because the OIDC provider has been
-renamed from ``oas`` to ``stackspin``. You can choose from these options:
+renamed from ``oas`` to ``stackspin`` and because the new SSO system uses UUIDs
+to uniquely identify users.
+
+You can choose from these options:
 
 1. Manually re-upload and re-share your files after logging into your new user
    for the first time.
 2. It is possible to transfer files from your previous user to the new user. To
-   do so:
+   do so, find your new username. It is visible in Settings -> Sharing behind
+   "Your Federated Cloud ID" after you've logged out and in to Nextcloud with
+   the new SSO (the part *before* the ``@``).
 
    .. code:: bash
 
@@ -89,7 +94,7 @@ renamed from ``oas`` to ``stackspin``. You can choose from these options:
       # Change to the www-data user
       su www-data -s /bin/bash
       # Repeat this command for each username
-      php occ files:transfer-ownership oas-<username> stackspin-<username>
+      php occ files:transfer-ownership oas-<old username> <new user ID>
       # Note: the files are tranferred to a subfolder in the new user's
       # directory
 
-- 
GitLab