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-l... - <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">l... (for development)</dt> + <dd> + Archives at <a href="https://www.redhat.com/archives/libvir-list">https://w... + </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/">libvir... - <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">... (for users)</dt> + <dd> + Archives at <a href="https://www.redhat.com/archives/libvirt-users">https:/... + </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"... (for release notices)</dt> + <dd> + Archives at <a href="https://www.redhat.com/archives/libvirt-announce">http... + </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