[Qemu-devel] [qemu-web PATCH v2] add support page

[Qemu-devel] [qemu-web PATCH v2] add support page

[Alex Bennée]

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.
+
+* 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

Re: [Qemu-devel] [qemu-web PATCH v2] add support page

[Daniel P. Berrangé]

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 :|

Re: [Qemu-devel] [qemu-web PATCH v2] add support page

[Paolo Bonzini]

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
> 

Re: [Qemu-devel] [qemu-web PATCH v2] add support page

[Alex Bennée]

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

Re: [Qemu-devel] [qemu-web PATCH v2] add support page

[Thomas Huth]

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

[Qemu-devel] [qemu-web PATCH v2] add support page

[Alex Bennée]

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.
+
+* 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