diff mbox series

[Webpage] add support page

Message ID 20190819105753.30913-1-alex.bennee@linaro.org
State New
Headers show
Series [Webpage] add support page | expand

Commit Message

Alex Bennée Aug. 19, 2019, 10:57 a.m. UTC
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>

---
 support.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 support.md

-- 
2.20.1

Comments

Marc-André Lureau Aug. 21, 2019, 7:06 a.m. UTC | #1
On Mon, Aug 19, 2019 at 2:58 PM Alex Bennée <alex.bennee@linaro.org> 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>


May be you should remove "bug reporting" and "contact" sections from
README, and link to this file instead?

anyway lgtm,
Reviewed-by: Marc-André Lureau <marcandre.lureau@redhat.com>


> ---

>  support.md | 37 +++++++++++++++++++++++++++++++++++++

>  1 file changed, 37 insertions(+)

>  create mode 100644 support.md

>

> diff --git a/support.md b/support.md

> new file mode 100644

> index 0000000..b9f4aa6

> --- /dev/null

> +++ b/support.md

> @@ -0,0 +1,37 @@

> +---

> +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 distribution you may be better served by asking through

> +your distribution's support channels. This includes questions about a

> +specifically packaged versions of QEMU. The developers are generally

> +concerned with the latest release and the current state of the [master

> +branch](https://git.qemu.org/?p=qemu.git).

> +

> +Questions about complex configurations of networking and storage are

> +usually met with a recommendation to use management tool like

> +[virt-manager](https://virt-manager.org/) from the [libvirt

> +project](https://libvirt.org/) to configure and run QEMU.

> +

> +* 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/)

> --

> 2.20.1

>

>



-- 
Marc-André Lureau
Stefan Hajnoczi Aug. 22, 2019, 2:33 p.m. UTC | #2
On Mon, Aug 19, 2019 at 11:57:53AM +0100, Alex Bennée wrote:

Good idea!

> +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 distribution you may be better served by asking through


s/distribution/Linux distribution/

> +your distribution's support channels. This includes questions about a

> +specifically packaged versions of QEMU. The developers are generally


s/versions/version/

s/developers/QEMU developers/

> +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 tool like


s/tool/tools/

> +[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."
diff mbox series

Patch

diff --git a/support.md b/support.md
new file mode 100644
index 0000000..b9f4aa6
--- /dev/null
+++ b/support.md
@@ -0,0 +1,37 @@ 
+---
+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 distribution you may be better served by asking through
+your distribution's support channels. This includes questions about a
+specifically packaged versions of QEMU. The developers are generally
+concerned with the latest release and the current state of the [master
+branch](https://git.qemu.org/?p=qemu.git).
+
+Questions about complex configurations of networking and storage are
+usually met with a recommendation to use management tool like
+[virt-manager](https://virt-manager.org/) from the [libvirt
+project](https://libvirt.org/) to configure and run QEMU.
+
+* 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/)