[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

[libvirt] [PATCHv2] docs: added libvirt-announce to contact page



Also added explicit links to the subscription and
archive pages for the user and developer mailing
lists.
---
Adjusted with the items from Erics review. :)
Posted this a few minutes ago without v2 in
subject line as well (forgot, oops).
 docs/contact.html.in |   87 +++++++++++++++++++++++++++++++++++---------------
 1 files changed, 61 insertions(+), 26 deletions(-)

diff --git a/docs/contact.html.in b/docs/contact.html.in
index 1a9f79a..62b7e2f 100644
--- 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.  First-time posts may 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>
-- 
1.7.3.2


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]