From 54a90aa5dd34fb3583965535be82b0a552f18c7d Mon Sep 17 00:00:00 2001
From: Timo Ludwig <ti.ludwig@web.de>
Date: Sun, 5 Mar 2023 12:26:55 +0100
Subject: [PATCH] Document caveats of Google contacts storage

- Group labels are not mapped to CATEGORIES property
- BDAY property is missing when date is incomplete
---
 docs/config.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/config.rst b/docs/config.rst
index 9b1ecd6..671d7d1 100644
--- a/docs/config.rst
+++ b/docs/config.rst
@@ -268,6 +268,14 @@ in terms of data safety**. See `this blog post
 <https://evertpot.com/google-carddav-issues/>`_ for the details.  Always back
 up your data.
 
+Another caveat is that Google group labels are not synced with vCard's
+`CATEGORIES <https://www.rfc-editor.org/rfc/rfc6350#section-6.7.1>`_ property
+(also see :gh:`814` and
+`upstream issue #36761530 <https://issuetracker.google.com/issues/36761530>`_
+for reference) and the
+`BDAY <https://www.rfc-editor.org/rfc/rfc6350#section-6.2.5>`_ property is not
+synced when only partial date information is present (e.g. the year is missing).
+
 At first run you will be asked to authorize application for Google account
 access.