Message ID | 20190909135842.25469-1-alex.bennee@linaro.org |
---|---|
State | New |
Headers | show |
Series | [qemu-web,v2] add support page | expand |
On Mon, Sep 09, 2019 at 02:58:42PM +0100, Alex Bennée wrote: > This is intended to be a useful page we can link to in the banner of > the IRC channel explaining the various support options someone might > have. > > Signed-off-by: Alex Bennée <alex.bennee@linaro.org> > Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> > > --- > v2 > - add cleanups suggested by Stefan > --- > support.md | 40 ++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 40 insertions(+) > create mode 100644 support.md I would have expected some other file to be modified to link to this page from elsewhere on the website too. > > diff --git a/support.md b/support.md > new file mode 100644 > index 0000000..9174bbb > --- /dev/null > +++ b/support.md > @@ -0,0 +1,40 @@ > +--- > +title: Support > +permalink: /support/ > +--- > + > +If you have a support question that is not answered by our > +[documentation](/documentation) you have a number of options available > +to you. > + > +If the question is specifically about the integration of QEMU with the > +rest of your Linux distribution you may be better served by asking > +through your distribution's support channels. This includes questions > +about a specifically packaged version of QEMU. The QEMU developers are > +generally concerned with the latest release and the current state of > +the [master branch](https://git.qemu.org/?p=qemu.git) and do not > +provide support for QEMU binaries shipped by Linux distributions. > + > +Questions about complex configurations of networking and storage are > +usually met with a recommendation to use management tools like > +[virt-manager](https://virt-manager.org/) from the [libvirt > +project](https://libvirt.org/) to configure and run QEMU. Management > +tools handle the low-level details of setting up devices that most > +users should not need to learn. > + > +* There is a > +[qemu-discuss@nongnu.org](https://lists.nongnu.org/mailman/listinfo/qemu-discuss) > +mailing list for user focused questions<br> > +If your question is more technical or architecture specific you may > +want to send your question to another of [QEMU's mailing > +lists](https://wiki.qemu.org/MailingLists) > + > +* A lot of developers hang around on IRC (network: irc.oftc.net, > +channel #qemu)<br> QEMU developers tend to hold normal office hours > +and are distributed around the world. Please be patient as you may > +have to wait some time for a response. If you can't leave IRC open and > +wait you may be better served by a mailing list. > + > +* If you think you have found a bug you can report it on [our bug > + tracker](https://bugs.launchpad.net/qemu/)<br> > +Please see our guide on [how to report a bug](/contribute/report-a-bug/) For this content though: Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> Regards, Daniel -- |: https://berrange.com -o- https://www.flickr.com/photos/dberrange :| |: https://libvirt.org -o- https://fstop138.berrange.com :| |: https://entangle-photo.org -o- https://www.instagram.com/dberrange :|
On 09/09/19 16:11, Daniel P. Berrangé wrote: > On Mon, Sep 09, 2019 at 02:58:42PM +0100, Alex Bennée wrote: >> This is intended to be a useful page we can link to in the banner of >> the IRC channel explaining the various support options someone might >> have. >> >> Signed-off-by: Alex Bennée <alex.bennee@linaro.org> >> Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> >> >> --- >> v2 >> - add cleanups suggested by Stefan >> --- >> support.md | 40 ++++++++++++++++++++++++++++++++++++++++ >> 1 file changed, 40 insertions(+) >> create mode 100644 support.md > > I would have expected some other file to be modified to link to this > page from elsewhere on the website too. Indeed, can't we just link it from the navigation bar (_includes/nav.html)? Paolo >> >> diff --git a/support.md b/support.md >> new file mode 100644 >> index 0000000..9174bbb >> --- /dev/null >> +++ b/support.md >> @@ -0,0 +1,40 @@ >> +--- >> +title: Support >> +permalink: /support/ >> +--- >> + >> +If you have a support question that is not answered by our >> +[documentation](/documentation) you have a number of options available >> +to you. >> + >> +If the question is specifically about the integration of QEMU with the >> +rest of your Linux distribution you may be better served by asking >> +through your distribution's support channels. This includes questions >> +about a specifically packaged version of QEMU. The QEMU developers are >> +generally concerned with the latest release and the current state of >> +the [master branch](https://git.qemu.org/?p=qemu.git) and do not >> +provide support for QEMU binaries shipped by Linux distributions. >> + >> +Questions about complex configurations of networking and storage are >> +usually met with a recommendation to use management tools like >> +[virt-manager](https://virt-manager.org/) from the [libvirt >> +project](https://libvirt.org/) to configure and run QEMU. Management >> +tools handle the low-level details of setting up devices that most >> +users should not need to learn. >> + >> +* There is a >> +[qemu-discuss@nongnu.org](https://lists.nongnu.org/mailman/listinfo/qemu-discuss) >> +mailing list for user focused questions<br> >> +If your question is more technical or architecture specific you may >> +want to send your question to another of [QEMU's mailing >> +lists](https://wiki.qemu.org/MailingLists) >> + >> +* A lot of developers hang around on IRC (network: irc.oftc.net, >> +channel #qemu)<br> QEMU developers tend to hold normal office hours >> +and are distributed around the world. Please be patient as you may >> +have to wait some time for a response. If you can't leave IRC open and >> +wait you may be better served by a mailing list. >> + >> +* If you think you have found a bug you can report it on [our bug >> + tracker](https://bugs.launchpad.net/qemu/)<br> >> +Please see our guide on [how to report a bug](/contribute/report-a-bug/) > > For this content though: > > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > > Regards, > Daniel >
Daniel P. Berrangé <berrange@redhat.com> writes: > On Mon, Sep 09, 2019 at 02:58:42PM +0100, Alex Bennée wrote: >> This is intended to be a useful page we can link to in the banner of >> the IRC channel explaining the various support options someone might >> have. >> >> Signed-off-by: Alex Bennée <alex.bennee@linaro.org> >> Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> >> >> --- >> v2 >> - add cleanups suggested by Stefan >> --- >> support.md | 40 ++++++++++++++++++++++++++++++++++++++++ >> 1 file changed, 40 insertions(+) >> create mode 100644 support.md > > I would have expected some other file to be modified to link to this > page from elsewhere on the website too. The initial use-case is to link from the IRC channel so I avoided making a decision on the layout of the rest of the page. > >> >> diff --git a/support.md b/support.md >> new file mode 100644 >> index 0000000..9174bbb >> --- /dev/null >> +++ b/support.md >> @@ -0,0 +1,40 @@ >> +--- >> +title: Support >> +permalink: /support/ >> +--- >> + >> +If you have a support question that is not answered by our >> +[documentation](/documentation) you have a number of options available >> +to you. >> + >> +If the question is specifically about the integration of QEMU with the >> +rest of your Linux distribution you may be better served by asking >> +through your distribution's support channels. This includes questions >> +about a specifically packaged version of QEMU. The QEMU developers are >> +generally concerned with the latest release and the current state of >> +the [master branch](https://git.qemu.org/?p=qemu.git) and do not >> +provide support for QEMU binaries shipped by Linux distributions. >> + >> +Questions about complex configurations of networking and storage are >> +usually met with a recommendation to use management tools like >> +[virt-manager](https://virt-manager.org/) from the [libvirt >> +project](https://libvirt.org/) to configure and run QEMU. Management >> +tools handle the low-level details of setting up devices that most >> +users should not need to learn. >> + >> +* There is a >> +[qemu-discuss@nongnu.org](https://lists.nongnu.org/mailman/listinfo/qemu-discuss) >> +mailing list for user focused questions<br> >> +If your question is more technical or architecture specific you may >> +want to send your question to another of [QEMU's mailing >> +lists](https://wiki.qemu.org/MailingLists) >> + >> +* A lot of developers hang around on IRC (network: irc.oftc.net, >> +channel #qemu)<br> QEMU developers tend to hold normal office hours >> +and are distributed around the world. Please be patient as you may >> +have to wait some time for a response. If you can't leave IRC open and >> +wait you may be better served by a mailing list. >> + >> +* If you think you have found a bug you can report it on [our bug >> + tracker](https://bugs.launchpad.net/qemu/)<br> >> +Please see our guide on [how to report a bug](/contribute/report-a-bug/) > > For this content though: > > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > > Regards, > Daniel -- Alex Bennée
On 09/09/2019 15.58, Alex Bennée wrote: > This is intended to be a useful page we can link to in the banner of > the IRC channel explaining the various support options someone might > have. > > Signed-off-by: Alex Bennée <alex.bennee@linaro.org> > Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com> > > --- > v2 > - add cleanups suggested by Stefan > --- > support.md | 40 ++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 40 insertions(+) > create mode 100644 support.md > > diff --git a/support.md b/support.md > new file mode 100644 > index 0000000..9174bbb > --- /dev/null > +++ b/support.md > @@ -0,0 +1,40 @@ > +--- > +title: Support > +permalink: /support/ > +--- > + > +If you have a support question that is not answered by our > +[documentation](/documentation) you have a number of options available > +to you. > + > +If the question is specifically about the integration of QEMU with the > +rest of your Linux distribution you may be better served by asking > +through your distribution's support channels. This includes questions > +about a specifically packaged version of QEMU. The QEMU developers are > +generally concerned with the latest release and the current state of > +the [master branch](https://git.qemu.org/?p=qemu.git) and do not > +provide support for QEMU binaries shipped by Linux distributions. > + > +Questions about complex configurations of networking and storage are > +usually met with a recommendation to use management tools like > +[virt-manager](https://virt-manager.org/) from the [libvirt > +project](https://libvirt.org/) to configure and run QEMU. Management > +tools handle the low-level details of setting up devices that most > +users should not need to learn. Maybe add a glue sentence here à la: "To get in touch with the people from the QEMU project, you have the following options:" > +* There is a > +[qemu-discuss@nongnu.org](https://lists.nongnu.org/mailman/listinfo/qemu-discuss) > +mailing list for user focused questions<br> > +If your question is more technical or architecture specific you may > +want to send your question to another of [QEMU's mailing > +lists](https://wiki.qemu.org/MailingLists) > + > +* A lot of developers hang around on IRC (network: irc.oftc.net, > +channel #qemu)<br> QEMU developers tend to hold normal office hours > +and are distributed around the world. Please be patient as you may > +have to wait some time for a response. If you can't leave IRC open and > +wait you may be better served by a mailing list. > + > +* If you think you have found a bug you can report it on [our bug > + tracker](https://bugs.launchpad.net/qemu/)<br> > +Please see our guide on [how to report a bug](/contribute/report-a-bug/) Maybe add a "." before the "<br>"s ? Apart from that, content looks fine to me, but please add a link to _includes/footer.html or _includes/nav.html. Thanks, Thomas
diff --git a/support.md b/support.md new file mode 100644 index 0000000..9174bbb --- /dev/null +++ b/support.md @@ -0,0 +1,40 @@ +--- +title: Support +permalink: /support/ +--- + +If you have a support question that is not answered by our +[documentation](/documentation) you have a number of options available +to you. + +If the question is specifically about the integration of QEMU with the +rest of your Linux distribution you may be better served by asking +through your distribution's support channels. This includes questions +about a specifically packaged version of QEMU. The QEMU developers are +generally concerned with the latest release and the current state of +the [master branch](https://git.qemu.org/?p=qemu.git) and do not +provide support for QEMU binaries shipped by Linux distributions. + +Questions about complex configurations of networking and storage are +usually met with a recommendation to use management tools like +[virt-manager](https://virt-manager.org/) from the [libvirt +project](https://libvirt.org/) to configure and run QEMU. Management +tools handle the low-level details of setting up devices that most +users should not need to learn. + +* There is a +[qemu-discuss@nongnu.org](https://lists.nongnu.org/mailman/listinfo/qemu-discuss) +mailing list for user focused questions<br> +If your question is more technical or architecture specific you may +want to send your question to another of [QEMU's mailing +lists](https://wiki.qemu.org/MailingLists) + +* A lot of developers hang around on IRC (network: irc.oftc.net, +channel #qemu)<br> QEMU developers tend to hold normal office hours +and are distributed around the world. Please be patient as you may +have to wait some time for a response. If you can't leave IRC open and +wait you may be better served by a mailing list. + +* If you think you have found a bug you can report it on [our bug + tracker](https://bugs.launchpad.net/qemu/)<br> +Please see our guide on [how to report a bug](/contribute/report-a-bug/)