Skip to content

Commit 656eff2

Browse files
authored
Update account info (#36)
1 parent ba8b909 commit 656eff2

File tree

2 files changed

+13
-7
lines changed

2 files changed

+13
-7
lines changed

.github/workflows/preview.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
name: Build preview
22

33
on:
4-
# Runs on pushes targeting the default branch
4+
# Runs on pushes not targeting the default branch
55
push:
66
branches-ignore: [main]
77

accounts_collections.rst

+12-6
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,9 @@ Contacts, events and tasks must be saved to a DAVx⁵ account so that DAVx⁵ ca
1313

1414
When you add a DAVx⁵ account, you need either an email address or a base URL as the starting point for service discovery. You can find the required base URL in your server manual or ask your IT department. See our `tested services <https://www.davx5.com/tested-with/>`_ for a list of servers/services and how they're used with DAVx⁵.
1515

16-
.. note::
17-
Because `restricted user profiles cannot add accounts <https://developer.android.com/guide/topics/manifest/application-element#requiredAccountType>`_, it is not possible to use DAVx⁵ in a restricted user profile (child profile).
16+
.. warning:: Always use DAVx⁵ to manage DAVx⁵ accounts. Do not create, delete or otherwise modify DAVx5 accounts manually.
17+
18+
Because `restricted user profiles cannot add accounts <https://developer.android.com/guide/topics/manifest/application-element#requiredAccountType>`_, it is not possible to use DAVx⁵ in a restricted user profile (child profile).
1819

1920

2021
How does service discovery work?
@@ -52,6 +53,7 @@ So, DAVx⁵ will query the base URL for both CalDAV and CardDAV and use whatever
5253

5354
If the URL is entered without scheme, ``https://`` will be prepended. `Use of CalDAV/CardDAV over plain HTTP is not recommended for security reasons. <https://tools.ietf.org/html/rfc6352#section-13>`_
5455

56+
5557
Address book accounts
5658
=====================
5759

@@ -68,11 +70,15 @@ So, DAVx⁵ defines a new account type "DAVx⁵ address book" beside the regular
6870

6971
For every synchronized CardDAV address book, a DAVx⁵ address book account is created automatically. When synchronizing "address books" of the main DAVx⁵ account, DAVx⁵ starts synchronizing contacts for every DAVx⁵ address book account.
7072

71-
.. warning::
72-
Do not create, modify or delete DAVx⁵ address book accounts directly. Use the DAVx⁵ app to configure synchronized address books instead.
73+
.. warning:: Do not create, modify or delete DAVx⁵ address book accounts directly. Use DAVx⁵ to configure synchronized address books instead.
74+
75+
DAVx⁵ address books accounts are named after their assocated CardDAV address book plus the account name plus an ID to make the account name unique.
76+
77+
Safe mode
78+
---------
7379

74-
DAVx⁵ address books accounts are named after the CardDAV address book which they are connected to, plus a hash of the URL, for instance: *My addresses (UA)*
75-
(in this case, the hash is *UA*). The hash is necessary when there are two address books with the same name.
80+
When the device is booted into *Safe mode*, Android removes all local DAVx⁵ contacts. This is because user apps like DAVx⁵ are not loaded in safe mode,
81+
so the system considers the contacts as "associated app is gone, should be deleted". They will however be dowloaded again at the next synchronization.
7682

7783

7884
Account names

0 commit comments

Comments
 (0)