diff mbox series

[qemu-web,v4] add support page

Message ID 20190909152302.19016-1-alex.bennee@linaro.org
State New
Headers show
Series [qemu-web,v4] add support page | expand

Commit Message

Alex Bennée Sept. 9, 2019, 3:23 p.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>

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

Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>


---
v2
  - add cleanups suggested by Stefan
v3
  - add link to nav bar
v4
  - add glue sentence and .'s as suggested by Thomas
---
 _includes/nav.html |  1 +
 support.md         | 43 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 support.md

-- 
2.20.1
diff mbox series

Patch

diff --git a/_includes/nav.html b/_includes/nav.html
index 241d83e..0c81e24 100644
--- a/_includes/nav.html
+++ b/_includes/nav.html
@@ -4,6 +4,7 @@ 
 			{% assign current = page.url | downcase | split: '/' %}
 			<li class='{% if page.url == '/' %}not-desktop {%endif %}home'><a href="/">Home</a>
 			</li><li {% if current[1] == 'download' %}class='current'{% endif %}><a href="/download">Download</a>
+			</li><li {% if current[1] == 'support' %}class='current'{% endif %}><a href="/support">Support</a>
 			</li><li {% if current[1] == 'contribute' %}class='current'{% endif %}><a href="/contribute">Contribute</a>
 			</li><li {% if current[1] == 'documentation' %}class='current'{% endif %}><a href="/documentation">Documentation</a>
 			</li><li {% if current[1] == 'blog' %}class='current'{% endif %}><a href="/blog">Blog</a></li>
diff --git a/support.md b/support.md
new file mode 100644
index 0000000..031f045
--- /dev/null
+++ b/support.md
@@ -0,0 +1,43 @@ 
+---
+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.
+
+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/)