[libvirt] [PATCH] docs: added libvirt-announce to contact page
Also added explicit links to the subscription and archive pages for the user and developer mailing lists. --- docs/contact.html.in | 77 +++++++++++++++++++++++++++++++++----------------- 1 files changed, 51 insertions(+), 26 deletions(-) diff --git a/docs/contact.html.in b/docs/contact.html.in index 1a9f79a..02b7c94 100644 --- a/docs/contact.html.in +++ b/docs/contact.html.in @@ -8,43 +8,68 @@ <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 mailing list is 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> + </dd> + + <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 mailing list is a place for discussions involving libvirt + <strong>users</strong>. 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/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-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 mailing list is 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. + The user and development mailing lists require you to subscribe before + posting to the list. Otherwise your posting will be delayed for manual + approval. You can subscribe at the linked webpages 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. </p> <h2><a name="irc">IRC discussion</a></h2> -- 1.7.3.2
On 01/04/2011 11:39 AM, Justin Clift wrote:
Also added explicit links to the subscription and archive pages for the user and developer mailing lists. --- docs/contact.html.in | 77 +++++++++++++++++++++++++++++++++----------------- 1 files changed, 51 insertions(+), 26 deletions(-)
Several suggestions:
- </ul> + <dt><a href="https://www.redhat.com/mailman/listinfo/libvir-list">libvir-list@redhat.com</a> (for development)</dt>
Mention that this is high-volume.
+ <dt><a href="https://www.redhat.com/mailman/listinfo/libvirt-users">libvirt-users@redhat.com</a> (for users)</dt> + <dd>
moderate volume
- </ul> + <dt><a href="https://www.redhat.com/mailman/listinfo/libvirt-announce">libvirt-announce@redhat.com</a> (for release notices)</dt> + <dd>
low-volume, and restricted posting
<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. + The user and development mailing lists require you to subscribe before + posting to the list. Otherwise your posting will be delayed for manual + approval. You can subscribe at the linked webpages above.
I'd reword this (I'm not a list admin, so I don't know the specifics of this list setup, but on other mailman-based lists that I do manage, non-subscribers can post after moderation delays and can be whitelisted even without subscription; and new subscribers are still subject to a first-time moderation delay to help cut down on spurious subscriptions for the purpose of spreading spam). If so, then this wording might be more accurate: It is recommended but not required that you subscribe before posting to user and development lists. First-time posts may be subject to manual moderation delays. You can subscribe at the linked webpages above.
<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.
Can we also point to our hacking.html page, which has better instructions for posting a patch? -- Eric Blake eblake@redhat.com +1-801-349-2682 Libvirt virtualization library http://libvirt.org
Also added explicit links to the subscription and archive pages for the user and developer mailing lists. --- Adjusted with the items from Erics review. :) 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
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
On 01/04/2011 12:24 PM, Justin Clift wrote:
Also added explicit links to the subscription and archive pages for the user and developer mailing lists.
<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.
This is the only hunk where I'd like confirmation from one of the list admins before you push (in case I'm wrong on list policies actually in place). But everything else looks good to me. -- Eric Blake eblake@redhat.com +1-801-349-2682 Libvirt virtualization library http://libvirt.org
Hey Daniel, Is Erics' text below (with the + 's) correct? Regards and best wishes, Justin Clift Begin forwarded message:
From: Eric Blake <eblake@redhat.com> Date: 5 January 2011 7:00:55 AM AEDT To: Justin Clift <jclift@redhat.com> Cc: libvir-list@redhat.com Subject: Re: [libvirt] [PATCHv2] docs: added libvirt-announce to contact page
On 01/04/2011 12:24 PM, Justin Clift wrote:
Also added explicit links to the subscription and archive pages for the user and developer mailing lists.
<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.
This is the only hunk where I'd like confirmation from one of the list admins before you push (in case I'm wrong on list policies actually in place). But everything else looks good to me.
-- Eric Blake eblake@redhat.com +1-801-349-2682 Libvirt virtualization library http://libvirt.org
On Wed, Jan 05, 2011 at 09:01:53AM +1100, Justin Clift wrote:
Hey Daniel,
Is Erics' text below (with the + 's) correct?
<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.
This is the only hunk where I'd like confirmation from one of the list admins before you push (in case I'm wrong on list policies actually in place). But everything else looks good to me.
Actually any post from a non-subscribed address will be delayed, not just the first time, so s/First-time/Non-subscribers/ and that should be fine. Daniel -- Daniel Veillard | libxml Gnome XML XSLT toolkit http://xmlsoft.org/ daniel@veillard.com | Rpmfind RPM search engine http://rpmfind.net/ http://veillard.com/ | virtualization library http://libvirt.org/
On 05/01/2011, at 3:02 PM, Daniel Veillard wrote:
On Wed, Jan 05, 2011 at 09:01:53AM +1100, Justin Clift wrote:
Hey Daniel,
Is Erics' text below (with the + 's) correct?
<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.
This is the only hunk where I'd like confirmation from one of the list admins before you push (in case I'm wrong on list policies actually in place). But everything else looks good to me.
Actually any post from a non-subscribed address will be delayed, not just the first time, so s/First-time/Non-subscribers/ and that should be fine.
Thanks. Pushed with that change. :) Regards and best wishes, Justin Clift
On Tue, Jan 04, 2011 at 01:00:55PM -0700, Eric Blake wrote:
On 01/04/2011 12:24 PM, Justin Clift wrote:
Also added explicit links to the subscription and archive pages for the user and developer mailing lists.
<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.
This is the only hunk where I'd like confirmation from one of the list admins before you push (in case I'm wrong on list policies actually in place). But everything else looks good to me.
The dev & user lists should both be listed as *requiring* subscribing before posting. Sometimes I will manually mark email addrs sent for modetration as allowed to post without subs, eg if we're having a discussion that is cross-posted to qemu-devel or similar, but we should tell users to subscribe otherwise their emails can easily sit in the moderation queue for days or weeks at a time or just be dropped entirely as spam is purged. Daniel
participants (4)
-
Daniel P. Berrange -
Daniel Veillard -
Eric Blake -
Justin Clift