document eMail notifications from codeberg (#213)

- Document how to change the eMail settings
- Document which situations automatically lead to being subscribed and
receiving mails

Improves on #153

Co-authored-by: Jan Klippel <c0d3b3rg@kl1pp3l.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/213
Co-authored-by: jklippel <jklippel@noreply.codeberg.org>
Co-committed-by: jklippel <jklippel@noreply.codeberg.org>

content/getting-started/communication-from-codeberg.md

@@ -1,11 +0,0 @@
----
-eleventyNavigation:
-  key: CommunicationCodeberg
-  title: Communication from Codeberg 
-  parent: GettingStarted
-  order: 65
----
-
-By default, Codeberg will send all your notifications to your registered email address.
-
-To change your preferences, you can click on your profile on the top-right corner, and from there, navigate to Settings->Account->Manage Email Addresses. Note that disabling e-mail notifications will not disable receiving important communication from Codeberg.

content/getting-started/email-settings.md

@@ -0,0 +1,36 @@
+---
+eleventyNavigation:
+  key: CommunicationCodeberg
+  title: Email Settings
+  parent: GettingStarted
+  order: 65
+---
+
+By default, the Gitea instance of Codeberg will send notifications to your registered Email address(es).
+
+## Configuring all notifications
+
+To change your preferences, go to your [user settings](https://codeberg.org/user/settings/account) or manually navigate to the settings.
+You can reach the preference settings by clicking on your profile in the top-right corner. From there navigate to Settings > Account Tab > Manage Email Addresses.
+
+In the section "Manage Email Addresses" you can select from one of the following options for each Email address that you registered with Codeberg:
+
+| Option                      | Effect                                                                                                         |
+|:----------------------------|:---------------------------------------------------------------------------------------------------------------|
+| Enable Email Notifications  | Enables all notifications (This is the default.)                                                               |
+| Only Email on Mention       | Codeberg will only send you an Email to this address if your username was mentioned in an issue or an comment. |
+| Disable Email Notifications | Codeberg will not send you any Emails to this Email address.                                                   |
+
+Make sure to press the "Set Email Preference" button after changing your selection.
+
+Note that disabling Email notifications will not disable receiving important communication from the Codeberg organisation.
+
+## Issue notifications
+
+As soon as you comment on an issue, you will be automatically subscribed to that issue. Unless you configured all your Email addresses to not receive any notifications, you will receive an Email for every comment and change on that issue. You can see and change the subscription in the "Notifications" section on the right side of the issue screen.
+
+## Watching repositories
+
+When you watch a repository (by clicking on the "Watch" button in the buttons bar of the repository), you will receive Emails for every change (creation of issues, PRs, comments, etc.) done in this repository. To unwatch a repository simply click on "Unwatch" in the buttons bar of the repository.
+
+Unfortunately Gitea does not yet provide the functionality to show you a list of all watched repositories [Gitea#16111](https://github.com/go-gitea/gitea/issues/16111).

content/redirects.md

@@ -9,6 +9,7 @@ redirects:
   - {"from": "/git/clone-commit-via-http/", "to": "/git/clone-commit-via-cli/"}
   - {"from": "/advanced/images-in-wiki-pages/", "to": "/getting-started/wiki/"}
   - {"from": "/faq/", "to": "/getting-started/faq/"}
+  - {"from": "/getting-started/communication-from-codeberg/", "to": "/getting-started/email-settings/" }
 permalink: "{{ redirect.from }}"
 layout: redirect
 ---