From 3af531fdcc304e4a191992ebfe254e33ba299fdd Mon Sep 17 00:00:00 2001
From: "Alexander \"PapaTutuWawa" <papatutuwawa@polynom.me>
Date: Sat, 13 Jan 2024 17:54:02 +0100
Subject: [PATCH] docs: Document the alt CNAME approach

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index 9843ecd..4011405 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,18 @@ _acme-challenge.cooldomain.rio. 3600    IN  CNAME   cooldomain.rio.pages.example
 This additionally requires your repository to have a file named `CNAME` that contains
 the domain to use (`cooldomain.rio` in this case).
 
+### Alternate CNAME Domains
+
+If there is a situation where you want to use a CNAME redirect on a (sub-) domain,
+where having a CNAME is not feasible, you can configure an "alternate CNAME".
+This is a special TXT record that contains the "CNAME" you want to specify.
+
+```
+; Example for Bind
+cooldomain.rio.                 3600    IN  A       <IPv4 of rio>
+_rio-cname.cooldomain.rio.      3600    IN  TXT     "cname=user.pages.example.org"
+```
+
 ### Repository Redirects
 
 If you have multiple repositories with pages (and you use a CNAME), you can additionally