docs: added libvirt-announce to contact page

Also added explicit links to the subscription and
archive pages for the user and developer mailing
lists.

diff --git a/docs/contact.html.in b/docs/contact.html.in
index 1a9f79a46ae10bf861aff04ef314d82fc40517c5..1f5103c4a8b79d625474eb847ce9254fa36bae16 100644 (file)
--- a/docs/contact.html.in
+++ b/docs/contact.html.in
@@ -8,43 +8,78 @@
     <h2><a name="email">Mailing lists</a></h2>
 
     <p>
-      There are two mailing-lists:
+      There are three mailing-lists:
     </p>
 
     <dl>
-      <dt><a href="https://www.redhat.com/archives/libvir-list/">libvir-list@redhat.com</a></dt>
-      <dd>This list a place for discussions about the <strong>development</strong> of libvirt. Topics for discussion include
-       <ul>
-         <li>New features for libvirt</li>
-         <li>Bug fixing of libvirt</li>
-         <li>New hypervisor drivers</li>
-         <li>Development of language bindings for libvirt API</li>
-         <li>Testing and documentation of libvirt</li>
-       </ul>
+      <dt><a href="https://www.redhat.com/mailman/listinfo/libvir-list">libvir-list@redhat.com</a> (for development)</dt>
+      <dd>
+        Archives at <a href="https://www.redhat.com/archives/libvir-list">https://www.redhat.com/archives/libvir-list</a>
+      </dd>
+      <dd>
+        This is a high volume mailing list.  It is a place for discussions
+        about the <strong>development</strong> of libvirt.
+      </dd>
+      <dd>
+        Topics for discussion include:
+        <ul>
+          <li>New features for libvirt</li>
+          <li>Bug fixing of libvirt</li>
+          <li>New hypervisor drivers</li>
+          <li>Development of language bindings for libvirt API</li>
+          <li>Testing and documentation of libvirt</li>
+        </ul>
       </dd>
 
-      <dt><a href="https://www.redhat.com/archives/libvirt-users/">libvirt-users@redhat.com</a></dt>
-      <dd>This list a place for discussions involving libvirt <strong>users</strong>. Topics for discussion include
-       <ul>
-         <li>Usage of libvirt / virsh</li>
-         <li>Administration of libvirtd</li>
-         <li>Deployment of libvirt with hypervisors</li>
-         <li>Development of applications on top of / using the libvirt API(s)</li>
-         <li>Any other topics along these lines</li>
-       </ul>
+      <dt><a href="https://www.redhat.com/mailman/listinfo/libvirt-users">libvirt-users@redhat.com</a> (for users)</dt>
+      <dd>
+        Archives at <a href="https://www.redhat.com/archives/libvirt-users">https://www.redhat.com/archives/libvirt-users</a>
+      </dd>
+      <dd>
+        This is a moderate volume mailing list.  It is a place for discussions
+        involving libvirt <strong>users</strong>.
       </dd>
+      <dd>
+        Topics for discussion include:
+        <ul>
+          <li>Usage of libvirt / virsh</li>
+          <li>Administration of libvirt</li>
+          <li>Deployment of libvirt with hypervisors</li>
+          <li>Development of applications on top of / using the libvirt API(s)</li>
+          <li>Any other topics along these lines</li>
+        </ul>
+      </dd>
+
+      <dt><a href="https://www.redhat.com/mailman/listinfo/libvirt-announce">libvirt-announce@redhat.com</a> (for release notices)</dt>
+      <dd>
+        Archives at <a href="https://www.redhat.com/archives/libvirt-announce">https://www.redhat.com/archives/libvirt-announce</a>
+      </dd>
+      <dd>
+        This is a low volume mailing list, with restricted posting, for
+        announcements of new libvirt releases.
+      </dd>
+      <dd>
+        Subscribe to just this if you want to be notified of new releases,
+        without subscribing to either of the other mailing lists.
+      </dd>
+
     </dl>
 
     <p>
-      Both mailing lists require that you subscribe before posting to the list,
-      otherwise your posting will be delayed for manual approval by mailman.
-      You can subscribe at the linked webpages above.
+      It is recommended but not required that you subscribe before posting
+      to the user and development lists.  Posts from non-subscribers will be
+      subject to manual moderation delays.  You can subscribe at the linked
+      web pages above.
     </p>
     <p>
-      Patches with explanations and provided as attachments are really appreciated and should
-      be directed to the development mailing list will be discussed on the mailing list.
-      If possible generate the patches by using <code>git format-patch</code> in a GIT
-      clone.
+      Patches with explanations and provided as attachments are really
+      appreciated, and should be directed to the development mailing list
+      for review and discussion.
+      Wherever possible, please generate the patches by using
+      <code>git format-patch</code> in a git repository clone.  Further
+      useful information regarding developing libvirt and/or contributing is
+      available on our <a href="hacking.html">Contributor Guidelines</a>
+      page.
     </p>
 
     <h2><a name="irc">IRC discussion</a></h2>