From c6a10eaf9fd9584fea599b3ffbc808f642851a74 Mon Sep 17 00:00:00 2001
From: Christoph Wurst <christoph@winzerhof-wurst.at>
Date: Fri, 12 May 2023 09:29:53 +0200
Subject: [PATCH] feat(adminmanual): Document system address book basics

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
---
 .../configuration_server/occ_command.rst      | 10 ++++++++--
 admin_manual/groupware/contacts.rst           | 19 +++++++++++++++++++
 admin_manual/groupware/index.rst              |  1 +
 3 files changed, 28 insertions(+), 2 deletions(-)
 create mode 100644 admin_manual/groupware/contacts.rst

diff --git a/admin_manual/configuration_server/occ_command.rst b/admin_manual/configuration_server/occ_command.rst
index 6f2349811..01409b047 100644
--- a/admin_manual/configuration_server/occ_command.rst
+++ b/admin_manual/configuration_server/occ_command.rst
@@ -515,8 +515,14 @@ bernie::
 
  sudo -u www-data php occ dav:sync-birthday-calendar bernie
 
-``dav:sync-system-addressbook`` synchronizes all users to the system
-addressbook::
+
+.. _occ-dav-sync-system-address-book:
+
+Sync system address book
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+``dav:sync-system-addressbook`` synchronizes all users to the :ref:`system
+address book<system-address-book>`::
 
  sudo -u www-data php occ dav:sync-system-addressbook
 
diff --git a/admin_manual/groupware/contacts.rst b/admin_manual/groupware/contacts.rst
new file mode 100644
index 000000000..152626b1d
--- /dev/null
+++ b/admin_manual/groupware/contacts.rst
@@ -0,0 +1,19 @@
+==================
+Contacts / CardDAV
+==================
+
+Nextcloud ships a CardDAV backend for users to store and share their address books and contacts.
+
+.. _system-address-book:
+
+System Address Book
+-------------------
+
+Nextcloud maintains a read-only address book containing contact information of all users of the instance.
+
+Disabled users are removed from this address book.
+
+Address Book Sync
+^^^^^^^^^^^^^^^^^
+
+The address book is updated automatically with every added, modified, disabled or removed user. Admins can also trigger a full rewrite of the address book :ref:`with occ<occ-dav-sync-system-address-book>`.
diff --git a/admin_manual/groupware/index.rst b/admin_manual/groupware/index.rst
index 753447f16..4ab89d8c0 100644
--- a/admin_manual/groupware/index.rst
+++ b/admin_manual/groupware/index.rst
@@ -7,4 +7,5 @@ Groupware
     :maxdepth: 2
 
     calendar
+    contacts
     mail
\ No newline at end of file