From f012da17a164165c1f7b91dc13f507835e1a44be Mon Sep 17 00:00:00 2001
From: Travis Ralston <travpc@gmail.com>
Date: Tue, 5 Nov 2019 16:00:55 -0700
Subject: [PATCH] Explain why e2e previews are bad

---
 api/client-server/content-repo.yaml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/api/client-server/content-repo.yaml b/api/client-server/content-repo.yaml
index 577e63b89..d596dbda3 100644
--- a/api/client-server/content-repo.yaml
+++ b/api/client-server/content-repo.yaml
@@ -346,7 +346,9 @@ paths:
 
         .. Note::
           Clients should consider avoiding this endpoint for URLs posted in encrypted
-          rooms.
+          rooms. Encrypted rooms often contain more sensitive information the users
+          do not want to share with the homeserver, and this can mean that the URLs
+          being shared should also not be shared with the homeserver.
 
       operationId: getUrlPreview
       produces: ["application/json"]