sync_windows10.rst: Cleanup and document TLSv1.2

- Remove redundant Contacts section. The remaining section works and is simpler.
- Remove redundant "repeat steps" step
- Move credit to the bottom as it is just a distraction
- Document the server-side TLSv1.2 requirement for Windows 10's schannel TLS client support.

Keywords for SEO: Windows 10 calendar contacts nextcloud owncloud caldav carddav sync

Author: skjnldsv

.docker/sphinx-latex/Dockerfile.orig

@@ -0,0 +1,34 @@
+FROM ubuntu:24.04
+
+LABEL org.opencontainers.image.source="https://github.com/nextcloud/documentation"
+LABEL org.opencontainers.image.description="Sphinx + LaTeX build environment for Nextcloud documentation"
+LABEL org.opencontainers.image.licenses="AGPL-3.0"
+
+ENV DEBIAN_FRONTEND=noninteractive
+# Allow pip to install packages system-wide inside the container
+ENV PIP_BREAK_SYSTEM_PACKAGES=1
+
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends \
+    curl \
+    git \
+<<<<<<< HEAD
+    lsb-release \
+=======
+>>>>>>> 18b2977d1 (ci: use Docker image for PDF builds, split HTML and PDF jobs)
+    make \
+    latexmk \
+    tex-gyre \
+    texlive-fonts-extra \
+    texlive-fonts-extra-links \
+    texlive-fonts-recommended \
+    texlive-latex-extra \
+    texlive-latex-recommended \
+    texlive-xetex \
+    xindy \
+  && mktexlsr \
+  && rm -rf /var/lib/apt/lists/*
+
+# Allow pip to install packages system-wide inside the container (used by
+# actions/setup-python and plain pip invocations running as root)
+RUN printf '[global]\nbreak-system-packages = true\n' > /etc/pip.conf

user_manual/groupware/sync_windows10.rst

@@ -21,50 +21,35 @@ Calendar
 
 8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Calendar"). Click "Save".
 
-
 Contacts
 --------
-1. In the bottom left of the Contacts View (in Nextcloud Contacts) look for a little (chain) link symbol that looks like this:
-
-.. image:: ../images/contacts_link.png
-
-which will display a URL that looks something like this:
-https://cloud.nextcloud.com/remote.php/dav/addressbooks/users/daniel/Thunderbird/
 
-2. Launch the Windows 10 Calendar app. Then, click the settings icon (gear icon) and select "Manage accounts".
-
-3. Click "Add account" and choose "iCloud".
-
-4. Enter an email, username and password. None of this information has to be valid-it will all be changed in the upcoming steps.
-
-5. Click "Sign in" and then "Done". A message should appear indicating the settings were saved successfully.
-
-6. In the "Manage Accounts" menu, click on  the iCloud account created in previous steps, and select "Change settings". Then, click on "Change mailbox sync settings".
-
-7. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)".
+1. Repeat steps 1–7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this.
 
-8. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud Contacts"). Click "Save".
+2. Scroll to the bottom of the dialog box, select "Advanced mailbox settings". Scroll once more to the bottom of the dialog box and paste your CardDAV URL in the field labelled "Contacts server (CardDAV)".
 
+3. Replace the path "principals" within the URL with "addressbooks".
 
-Troubleshooting
----------------
+4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save".
 
-After following all these steps, your Nextcloud calendar should synchronize. If not, check your username and password. Otherwise, repeat these steps.
+Troubleshooting: 2FA
+--------------------
 
 **NOTE: You will not be able to synchronize your calendar if you have two-factor authentication enabled. Follow the steps below to get an app password that can be used with the Calendar client app:**
 
 1. Log into Nextcloud. Click on your user icon, then click on "Settings".
 
 2. Click on "Security", then locate a button labeled "Create new app password". Next to this button, enter "Windows 10 Calendar app". Then, click the button, copy and paste the password. Use this password instead of your Nextcloud password for Step 8.
 
+Troubleshooting: TLSv1.2
+------------------------
 
-Contacts
---------
-
-1. Repeat steps 1–7 from the Calendar instructions. If you already have setup the Calendar synchronization, you can use the same account for this.
+- For Windows 10 your Nextcloud https server `must support TLSv1.2`_.  This is apparent if no connection attempts are seen on the server, and the Windows client Event Viewer will display Schannel TLS errors under "Windows Logs -> System".
 
-2. In the "Advanced mailbox settings" paste your CalDAV URL in the field labelled "Contacts server (CardDAV)".
+Credits
+------
 
-3. Replace the path "principals" within the URL with "addressbooks".
+Special thanks to this Reddit user for their post:
+https://www.reddit.com/r/Nextcloud/comments/5rcypb/using_the_windows_10_calendar_application_with/
 
-4. Click "Done". Enter your Nextcloud username and password in the appropriate fields, and change the account name to whatever you prefer (e. g. "Nextcloud"). Click "Save".
+.. _must support TLSv1.2: https://docs.microsoft.com/en-us/windows/win32/secauthn/protocols-in-tls-ssl--schannel-ssp-