From c0b733171cece921b5e7408dff3643ddb297475e Mon Sep 17 00:00:00 2001 From: Anna Larch Date: Thu, 16 Apr 2026 14:23:44 +0200 Subject: [PATCH] docs: resolve TODO comments in admin manual server_tuning.rst: - Add introductory paragraph describing the page purpose - Remove three TODO comments (intro, sorting, impact table) theming.rst: - Remove resolved TODO comment from Branded clients section profile_configuration.rst: - Add "Scopes and existing users" section documenting that scope defaults only apply to new users and that there is no admin-level mechanism to bulk-change scopes for existing users - Document the OCS API for users to update their own scopes - Add "See also" section with cross-links to sharing configuration and user manual personal settings AI-Assisted-By: Claude Opus 4.6 Signed-off-by: Anna Larch --- admin_manual/configuration_server/theming.rst | 2 - .../profile_configuration.rst | 56 ++++++++++++++----- admin_manual/installation/server_tuning.rst | 7 ++- 3 files changed, 45 insertions(+), 20 deletions(-) diff --git a/admin_manual/configuration_server/theming.rst b/admin_manual/configuration_server/theming.rst index 5d4f8ea724c..7a113bc2f07 100644 --- a/admin_manual/configuration_server/theming.rst +++ b/admin_manual/configuration_server/theming.rst @@ -65,8 +65,6 @@ This requires: Branded clients --------------- -.. TODO: Consider dropping this section (other than the note) since this isn't even available/applicable for non-enterprise users (who presumably will use docs at https://portal.nextcloud.com). - .. note:: Nextcloud GmbH - the company that employs Nextcloud's core maintainers - offers branding services, providing sync clients (mobile and desktop) that use your corporate identity and are pre-configured for your users. For more information on advanced branding and enterprise support offerings, `contact Nextcloud GmbH `_. The theming app supports changing the URLs for the mobile apps (Android and iOS) that appear when users access the web interface from mobile devices. By default, these links point to the official Nextcloud apps, but you can set them to branded versions. diff --git a/admin_manual/configuration_user/profile_configuration.rst b/admin_manual/configuration_user/profile_configuration.rst index 845432ef2b0..00ba8a1d409 100644 --- a/admin_manual/configuration_user/profile_configuration.rst +++ b/admin_manual/configuration_user/profile_configuration.rst @@ -380,19 +380,45 @@ With more restrictive scopes (especially ``Private``), expect reduced visibility In short: tighter privacy reduces profile-based convenience and discoverability. -.. TODO/Future additions - - Sharing settings + Mentions + Property Scope interactions (i.e. auto-completion, group/user-to-group/user sharing) - - Since default visibility scope changes only apply to new users, perhaps we can cover whether there's a migration path for existing users? - - better integrate (cross-link? separate out?) with chapters covering sharing and federation - - unify with User Manual - - Dev Manual coverage - - better distinguish user facing profile field visibility settings from admin instance-level scope settings - - better "known user context" description - - better "public contexts" description - - better "lookup server" description/context - - https://github.com/nextcloud/lookup-server?tab=readme-ov-file#what-is-lookup-server - - https://github.com/nextcloud/lookup-server/blob/master/doc/architecture.md#overview - - better "varies by feature/UI/API/app" description - - more definite statements; more direct statements - - simplify simplify simplify +Scopes and existing users +------------------------- + +The ``account_manager.default_property_scope`` config only applies to **new** users. +Existing users keep their stored scopes. + +There is currently no admin-level mechanism to bulk-change scopes for existing +users. The OCS provisioning API only allows users to change their **own** scopes — +admins cannot set scopes on behalf of other users. + +Users can update their own scopes in **Personal settings** → **Personal info** → +**Edit your Profile visibility**, or via the API:: + + curl -s -u alice:password -X PUT \ + "https://cloud.example.com/ocs/v2.php/cloud/users/alice" \ + -H "OCS-APIRequest: true" \ + -d "key=phoneScope&value=v2-private" + +The scope key is the property name with ``Scope`` appended. Available keys: + +``displaynameScope``, ``emailScope``, ``phoneScope``, ``addressScope``, +``websiteScope``, ``twitterScope``, ``blueskyScope``, ``fediverseScope``, +``organisationScope``, ``roleScope``, ``headlineScope``, ``biographyScope``, +``birthdateScope``, ``avatarScope``, ``pronounsScope`` + +Allowed scope values: + +- ``v2-private`` — Private +- ``v2-local`` — Local +- ``v2-federated`` — Federated +- ``v2-published`` — Published + +.. note:: + ``displaynameScope`` and ``emailScope`` cannot be set to ``v2-private``. + The server enforces a minimum of ``v2-local`` for these properties. + +See also +-------- + +- :doc:`../configuration_files/file_sharing_configuration` — sharing and autocomplete settings that interact with profile visibility +- `User manual: Personal settings `_ — user-facing profile and personal info settings diff --git a/admin_manual/installation/server_tuning.rst b/admin_manual/installation/server_tuning.rst index c24f38a0d96..f33d2113b67 100644 --- a/admin_manual/installation/server_tuning.rst +++ b/admin_manual/installation/server_tuning.rst @@ -2,9 +2,10 @@ Server tuning ============= -.. TODO: Add introductory paragraph -.. TODO: Sort according to (generalized) difficulty -.. TODO: Consider adding a category (or even table) with Impact vs Difficulty +This page collects configuration changes that can improve the performance of +your Nextcloud server. Most items only require editing a configuration file or +installing a package, while a few involve additional services. Start with the +ones that match your setup and revisit the rest as your instance grows. Using cron to perform background jobs -------------------------------------