diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst
index 1893f37bc..83c8998e1 100644
--- a/admin_manual/configuration_server/config_sample_php_parameters.rst
+++ b/admin_manual/configuration_server/config_sample_php_parameters.rst
@@ -243,6 +243,8 @@ installer. (There are also per-user salts.) If you lose this salt you lose
 all your passwords. This example is for documentation only, and you should
 never use it.
 
+.. deprecated:: This salt is deprecated and only used for legacy-compatibility, developers should *NOT* use this value for anything nowadays.  'passwordsalt' => 'd3c944a9af095aa08f',
+
 secret
 ^^^^^^
 
@@ -2317,6 +2319,8 @@ Sort groups in the user settings by name instead of the user count
 
 By enabling this the user count beside the group name is disabled as well.
 
+.. deprecated:: since Nextcloud 29 - Use the frontend instead or set the app config value `group.sortBy` for `core` to `2`
+
 Comments
 --------