From 28ca7d3141c469432e4e25334a6c20973abf1b89 Mon Sep 17 00:00:00 2001
From: polarathene <5098581+polarathene@users.noreply.github.com>
Date: Sat, 27 Jan 2024 14:11:38 +1300
Subject: [PATCH] chore: Temporary commit

---
 docs/content/config/account-management/overview.md    | 11 +++++++++--
 .../config/account-management/provisioner/file.md     |  3 +++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/content/config/account-management/overview.md b/docs/content/config/account-management/overview.md
index 34691f27..76d6e3dc 100644
--- a/docs/content/config/account-management/overview.md
+++ b/docs/content/config/account-management/overview.md
@@ -4,7 +4,7 @@
 
 `ACCOUNT_PROVISIONER` and supplementary pages referenced here.
 
-Anchor heading links stubbed out below.
+An account has an email address `local-part@domain-part`.
 
 ### Accounts
 
@@ -17,7 +17,11 @@ An alias is a full email address that will either be:
 - Delivered to an existing account
 - Redirected to one or more other email addresses
 
-### Address Tags (Extension Delimiters) as an alternative to Aliases
+Known issues
+Alias and Account names cannot overlap
+Wildcard and need to alias each real account.. (no longer supported?)
+
+### Sub-addressing (aka Plus Addressing / Extension Tags)
 
 Postfix supports so-called address tags, in the form of plus (+) tags - i.e. `address+tag@example.com` will end up at `address@example.com`.
 
@@ -39,6 +43,9 @@ This is configured by default and the (configurable!) separator is set to `+`. F
 - `imap-quota` is enabled and allow clients to query their mailbox usage.
 - Dovecot quotas are compatible with LDAP, **but it's not implemented** (_PRs are welcome!_).
 
+Known issues
+default feature enabled, dovecot creates dummy accounts to workaround alias limitation.
+
 ## Technical Overview
 
 - Postfix handles when mail is delivered (inbound) to DMS, or sent (outbound) from DMS.
diff --git a/docs/content/config/account-management/provisioner/file.md b/docs/content/config/account-management/provisioner/file.md
index 801ffcf1..4e1f1fc6 100644
--- a/docs/content/config/account-management/provisioner/file.md
+++ b/docs/content/config/account-management/provisioner/file.md
@@ -36,6 +36,9 @@ alias1@example.com user1@example.com
 alias2@example.com external-account@gmail.com
 ```
 
+Multiple recipients can be added to one alias, but is not officially supported.
+https://github.com/orgs/docker-mailserver/discussions/3805#discussioncomment-8215417
+
 ### Configuring RegExp Aliases
 
 - Additional regexp aliases can be configured by placing them into `docker-data/dms/config/postfix-regexp.cf`.