1 files changed, 16 insertions, 9 deletions

diff --git a/Mailman/interfaces/mlistweb.py b/Mailman/interfaces/mlistweb.py
index 16eb94281..728fd1990 100644
--- a/Mailman/interfaces/mlistweb.py
+++ b/Mailman/interfaces/mlistweb.py
@@ -21,19 +21,26 @@ from zope.interface import Interface, Attribute
 
 
 
-class IMailingListURLs(Interface):
+class IMailingListWeb(Interface):
     """The web addresses associated with a mailing list."""
 
     protocol = Attribute(
-        """The web protocol to use to contact the server providing the web
-        interface for this mailing list, e.g. 'http' or 'https'.""")
+        """The protocol scheme used to contact this list's server.
+
+        The web server on thi protocol provides the web interface for this
+        mailing list.  The protocol scheme should be 'http' or 'https'.""")
 
     web_host = Attribute(
-        """The read-only domain name of the host to contact for interacting
-        with the web interface of the mailing list.""")
+        """This list's web server's domain.
+
+        The read-only domain name of the host to contact for interacting with
+        the web interface of the mailing list.""")
 
     def script_url(target, context=None):
-        """Return the url to the given script target.  If 'context' is not
-        given, or is None, then an absolute url is returned.  If context is
-        given, it must be an IMailingListRequest object, and the returned url
-        will be relative to that object's 'location' attribute."""
+        """Return the url to the given script target.
+
+        If 'context' is not given, or is None, then an absolute url is
+        returned.  If context is given, it must be an IMailingListRequest
+        object, and the returned url will be relative to that object's
+        'location' attribute.
+        """