=== modified file 'src/mailman/rest/docs/domains.rst'
--- src/mailman/rest/docs/domains.rst	2011-08-23 18:30:48 +0000
+++ src/mailman/rest/docs/domains.rst	2011-08-30 11:42:45 +0000
@@ -249,5 +249,24 @@
     ...
     HTTPError: HTTP Error 404: 404 Not Found
 
+Mailing lists should be removed when associated domains are deleted.
+
+    >>> dump_json('http://localhost:9001/3.0/lists/test-domains@example.com')
+    fqdn_listname: test-domains@example.com
+    http_etag: "..."
+    ...
+    self_link: http://localhost:9001/3.0/lists/test-domains@example.com
+
+    >>> dump_json('http://localhost:9001/3.0/domains/example.com',
+    ...           method='DELETE')
+    content-length: 0
+    date: ...
+    server: ...
+    status: 204
+
+    >>> dump_json('http://localhost:9001/3.0/lists/test-domains@example.com')
+    Traceback (most recent call last):
+    ...
+    HTTPError: HTTP Error 404: 404 Not Found
 
 .. _Domains: ../../model/docs/domains.html