Avoid some confusion about server objects

diff --git a/docs/common/api/server.rst b/docs/common/api/server.rst
index 10245939e36e0c236b91cedc9bccf75c2e7509cc..d1b4008b89bc56cde8a231bb112811eaaae0dddb 100644 (file)
--- a/docs/common/api/server.rst
+++ b/docs/common/api/server.rst
@@ -5,7 +5,7 @@ Server
   An object representing a single PowerDNS server.
   In the built-in API, only one Server exists (called "localhost").
 
-  pdnsmgrd and pdnscontrol MUST NOT return “localhost”, but SHOULD return
+  A proxy that allows control of multiple servers MUST NOT return “localhost”, but SHOULD return
   other servers.
 
   :property string type: Set to "Server"
@@ -30,6 +30,4 @@ Server
       "zones_url": "/api/v1/servers/localhost/zones{/zone}",
     }
 
-  Note: the servers collection is read-only, and the only allowed returned server is read-only as well.
-  On a pdnscontrol server, the servers collection is read-write, and the returned server resources are read-write as well.
-  Write permissions may depend on the credentials you have supplied.
+  Note: the servers collection is read-only, and the only allowed returned server is read-only as well. A control proxy could return modifyable resources.