Merge pull request 'Add moderation documentation' (#246) from Gusted/website:forgejo-moderation-docs into main

Reviewed-on: https://codeberg.org/forgejo/website/pulls/246
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Reviewed-by: Otto <otto@codeberg.org>

developer/WORKFLOW.md

@@ -91,6 +91,11 @@ The purpose of each _Feature branch_ is documented below:
   Customize Forgejo to have more privacy.
   - Backports: [v1.19/forgejo-privacy](https://codeberg.org/forgejo/forgejo/src/branch/v1.19/forgejo-privacy)
 
+### Moderation
+
+- [forgejo-moderation](https://codeberg.org/forgejo/forgejo/src/branch/forgejo-moderation) based on [forgejo-development](https://codeberg.org/forgejo/forgejo/src/branch/forgejo-development)
+  Add moderation tooling for users and admins.
+
 ### Branding
 
 - [forgejo-branding](https://codeberg.org/forgejo/forgejo/src/branch/forgejo-branding) based on [forgejo-development](https://codeberg.org/forgejo/forgejo/src/branch/forgejo-development)

user/blocking-user.md

@@ -0,0 +1,31 @@
+---
+layout: '~/layouts/Markdown.astro'
+title: Blocking a user
+license: 'CC-BY-SA-4.0'
+---
+
+Blocking another user is desirable if they are acting maliciously or are spamming your repository. For such cases, Forgejo provides the functionality to block other users. Please note that in this version, you can only block another user from your own account and not from an organization's account. When you block a user, Forgejo does not explicitly notify them, but they may learn through an interaction with you that is blocked.
+
+## How to block someone
+
+In order to block another user, go to their profile page and click on the "Block" button.
+
+![Profile card where block button is shown](../../../../images/v1.20/user/block/profile.png)
+
+A popup will show; please read carefully what blocking another user implies, and if you accept the implications, click on Yes.
+
+![Popup where implications of the block action is listed](../../../../images/v1.20/user/block/popup.png)
+
+## Implications of blocking a user
+
+When you block a user:
+
+- You stop following them.
+- They stop following you.
+
+After you've blocked them:
+
+- They cannot cause any notifications for you anymore by mentioning you.
+- They cannot open issues or pull requests on repository you own.
+- They cannot add reactions to your comments.
+- They cannot post comments on issues and pull request you've opened.

user/index.md

@@ -21,6 +21,7 @@ involved in running it on their machines.
   - [Citable Code](https://docs.codeberg.org/collaborating/citable-code/)
   - [Labels](labels)
   - [Automatically Linked References](linked-references)
+  - [Blocking users](blocking-user)
 - Working with Git Repositories
   - [Clone & Commit via Web](https://docs.codeberg.org/git/clone-commit-via-web/)
   - [Tags and Releases](https://docs.codeberg.org/git/using-tags/)