Editing QEMU POWER Platform wiki page

Editing QEMU POWER Platform wiki page

[Leonardo Augusto Guimarães Garcia]

Hi there,

I would like to edit the wiki page at [0] as it contains some outdated 
information. Could anyone that has access to the wiki please help me 
create a user so that I can edit it?

0. https://wiki.qemu.org/Documentation/Platforms/POWER

Cheers,

Leo

Re: Editing QEMU POWER Platform wiki page

[Greg Kurz]

On Thu, 18 Feb 2021 10:16:25 -0300
Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:

> Hi there,
> 
> I would like to edit the wiki page at [0] as it contains some outdated 
> information. Could anyone that has access to the wiki please help me 
> create a user so that I can edit it?
> 
> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
> 

Hi Leo,

User creation isn't publicly available to avoid spam : only an existing
user can create a new account. This being said, wiki isn't the preferred
way to expose documentation since there's no review and things ultimately
bitrot. Page [0] you want to update is a perfect example of the mess :
not only it contains irrelevant data but also stuff that is definitely
wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will
be removed in QEMU 6.0).

Ideally we'd want everything to be in the main QEMU doc and don't
even need a wiki.

On the PowerPC front, the most up-to-date docs are in the QEMU tree:

docs/system/ppc/embedded.rst 
docs/system/ppc/powermac.rst 
docs/system/ppc/powernv.rst  
docs/system/ppc/prep.rst     
docs/system/ppc/pseries.rst  
docs/system/target-ppc.rst   

So I don't know exactly what changes you had in mind, but maybe first
consider to update the main documentation.

On my side, I think I want do ditch all the current content and just put
links to https://qemu.readthedocs.io/en/latest/ instead. I can take care
of that, in which case you wouldn't need an account.

Cheers,

--
Greg

PS:

Cedric reported that we also have a page for non-pseries
platforms:

https://wiki.qemu.org/Documentation/Platforms/PowerPC

I'm Cc'ing some regular contributors for those platforms so
they can  evaluate the bitrotting status of this wiki.

> Cheers,
> 
> Leo
> 
> 

Re: Editing QEMU POWER Platform wiki page

[Cédric Le Goater]

On 2/22/21 12:01 PM, Greg Kurz wrote:
> On Thu, 18 Feb 2021 10:16:25 -0300
> Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
> 
>> Hi there,
>>
>> I would like to edit the wiki page at [0] as it contains some outdated 
>> information. Could anyone that has access to the wiki please help me 
>> create a user so that I can edit it?
>>
>> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
>>
> 
> Hi Leo,
> 
> User creation isn't publicly available to avoid spam : only an existing
> user can create a new account. This being said, wiki isn't the preferred
> way to expose documentation since there's no review and things ultimately
> bitrot. Page [0] you want to update is a perfect example of the mess :
> not only it contains irrelevant data but also stuff that is definitely
> wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will
> be removed in QEMU 6.0).
> 
> Ideally we'd want everything to be in the main QEMU doc and don't
> even need a wiki.
> 
> On the PowerPC front, the most up-to-date docs are in the QEMU tree:
> 
> docs/system/ppc/embedded.rst 
> docs/system/ppc/powermac.rst 
> docs/system/ppc/powernv.rst  
> docs/system/ppc/prep.rst     
> docs/system/ppc/pseries.rst  
> docs/system/target-ppc.rst   
> 
> So I don't know exactly what changes you had in mind, but maybe first
> consider to update the main documentation.

This structure doesn't quite exist yet. See the patch below adding it.

I would like to improve the PowerNV section before sending it.  

Thanks,

C. 


From f64cf0ab37848c44271437ef837ddda66206c4b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Le=20Goater?= <clg@kaod.org>
Date: Mon, 22 Feb 2021 12:12:23 +0100
Subject: [PATCH] docs/system: Extend PPC section
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Cédric Le Goater <clg@kaod.org>
---
 docs/system/ppc/embedded.rst | 10 +++++++
 docs/system/ppc/powermac.rst | 34 +++++++++++++++++++++++
 docs/system/ppc/powernv.rst  | 11 ++++++++
 docs/system/ppc/prep.rst     | 18 ++++++++++++
 docs/system/ppc/pseries.rst  | 12 ++++++++
 docs/system/target-ppc.rst   | 53 ++++++++++--------------------------
 6 files changed, 100 insertions(+), 38 deletions(-)
 create mode 100644 docs/system/ppc/embedded.rst
 create mode 100644 docs/system/ppc/powermac.rst
 create mode 100644 docs/system/ppc/powernv.rst
 create mode 100644 docs/system/ppc/prep.rst
 create mode 100644 docs/system/ppc/pseries.rst

diff --git a/docs/system/ppc/embedded.rst b/docs/system/ppc/embedded.rst
new file mode 100644
index 000000000000..cfffbda24da9
--- /dev/null
+++ b/docs/system/ppc/embedded.rst
@@ -0,0 +1,10 @@
+Embedded family boards
+======================
+
+- ``bamboo``               bamboo
+- ``mpc8544ds``            mpc8544ds
+- ``ppce500``              generic paravirt e500 platform
+- ``ref405ep``             ref405ep
+- ``sam460ex``             aCube Sam460ex
+- ``taihu``                taihu
+- ``virtex-ml507``         Xilinx Virtex ML507 reference design
diff --git a/docs/system/ppc/powermac.rst b/docs/system/ppc/powermac.rst
new file mode 100644
index 000000000000..04334ba2102c
--- /dev/null
+++ b/docs/system/ppc/powermac.rst
@@ -0,0 +1,34 @@
+PowerMac family boards (``g3beige``, ``mac99``)
+==================================================================
+
+Use the executable ``qemu-system-ppc`` to simulate a complete PowerMac
+PowerPC system.
+
+- ``g3beige``              Heathrow based PowerMAC
+- ``mac99``                Mac99 based PowerMAC
+
+Supported devices
+-----------------
+
+QEMU emulates the following PowerMac peripherals:
+
+ *  UniNorth or Grackle PCI Bridge
+ *  PCI VGA compatible card with VESA Bochs Extensions
+ *  2 PMAC IDE interfaces with hard disk and CD-ROM support
+ *  NE2000 PCI adapters
+ *  Non Volatile RAM
+ *  VIA-CUDA with ADB keyboard and mouse.
+
+
+Missing devices
+---------------
+
+ * To be identified
+
+Firmware
+--------
+
+Since version 0.9.1, QEMU uses OpenBIOS https://www.openbios.org/ for
+the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
+(GPL v2) portable firmware implementation. The goal is to implement a
+100% IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
diff --git a/docs/system/ppc/powernv.rst b/docs/system/ppc/powernv.rst
new file mode 100644
index 000000000000..28ce09aa4513
--- /dev/null
+++ b/docs/system/ppc/powernv.rst
@@ -0,0 +1,11 @@
+PowerNV family boards (``powernv8``, ``powernv9``)
+==================================================================
+
+Supported devices
+-----------------
+
+Missing devices
+---------------
+
+Firmware
+--------
diff --git a/docs/system/ppc/prep.rst b/docs/system/ppc/prep.rst
new file mode 100644
index 000000000000..bd9eb8eabd2f
--- /dev/null
+++ b/docs/system/ppc/prep.rst
@@ -0,0 +1,18 @@
+Prep machine (``40p``)
+==================================================================
+
+Use the executable ``qemu-system-ppc`` to simulate a complete 40P (PREP)
+
+Supported devices
+-----------------
+
+QEMU emulates the following 40P (PREP) peripherals:
+
+ *  PCI Bridge
+ *  PCI VGA compatible card with VESA Bochs Extensions
+ *  2 IDE interfaces with hard disk and CD-ROM support
+ *  Floppy disk
+ *  PCnet network adapters
+ *  Serial port
+ *  PREP Non Volatile RAM
+ *  PC compatible keyboard and mouse.
diff --git a/docs/system/ppc/pseries.rst b/docs/system/ppc/pseries.rst
new file mode 100644
index 000000000000..932d4dd17d29
--- /dev/null
+++ b/docs/system/ppc/pseries.rst
@@ -0,0 +1,12 @@
+pSeries family boards (``pseries``)
+===================================
+
+Supported devices
+-----------------
+
+Missing devices
+---------------
+
+
+Firmware
+--------
diff --git a/docs/system/target-ppc.rst b/docs/system/target-ppc.rst
index a2f04c533c24..549fb1858b54 100644
--- a/docs/system/target-ppc.rst
+++ b/docs/system/target-ppc.rst
@@ -3,45 +3,22 @@
 PowerPC System emulator
 -----------------------
 
-Use the executable ``qemu-system-ppc`` to simulate a complete 40P (PREP)
-or PowerMac PowerPC system.
+Board-specific documentation
+============================
 
-QEMU emulates the following PowerMac peripherals:
+you can get a complete list by running ``qemu-system-ppc64 --machine
+help``.
 
--  UniNorth or Grackle PCI Bridge
+..
+   This table of contents should be kept sorted alphabetically
+   by the title text of each file, which isn't the same ordering
+   as an alphabetical sort by filename.
 
--  PCI VGA compatible card with VESA Bochs Extensions
+.. toctree::
+   :maxdepth: 1
 
--  2 PMAC IDE interfaces with hard disk and CD-ROM support
-
--  NE2000 PCI adapters
-
--  Non Volatile RAM
-
--  VIA-CUDA with ADB keyboard and mouse.
-
-QEMU emulates the following 40P (PREP) peripherals:
-
--  PCI Bridge
-
--  PCI VGA compatible card with VESA Bochs Extensions
-
--  2 IDE interfaces with hard disk and CD-ROM support
-
--  Floppy disk
-
--  PCnet network adapters
-
--  Serial port
-
--  PREP Non Volatile RAM
-
--  PC compatible keyboard and mouse.
-
-Since version 0.9.1, QEMU uses OpenBIOS https://www.openbios.org/ for
-the g3beige and mac99 PowerMac and the 40p machines. OpenBIOS is a free
-(GPL v2) portable firmware implementation. The goal is to implement a
-100% IEEE 1275-1994 (referred to as Open Firmware) compliant firmware.
-
-More information is available at
-http://perso.magic.fr/l_indien/qemu-ppc/.
+   ppc/embedded
+   ppc/powermac
+   ppc/powernv
+   ppc/prep
+   ppc/pseries
-- 
2.26.2

Re: Editing QEMU POWER Platform wiki page

[Programmingkid]

> On Feb 22, 2021, at 6:01 AM, Greg Kurz <groug@kaod.org> wrote:
> 
> On Thu, 18 Feb 2021 10:16:25 -0300
> Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
> 
>> Hi there,
>> 
>> I would like to edit the wiki page at [0] as it contains some outdated 
>> information. Could anyone that has access to the wiki please help me 
>> create a user so that I can edit it?
>> 
>> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
>> 
> 
> Hi Leo,
> 
> User creation isn't publicly available to avoid spam : only an existing
> user can create a new account. This being said, wiki isn't the preferred
> way to expose documentation since there's no review and things ultimately
> bitrot. Page [0] you want to update is a perfect example of the mess :
> not only it contains irrelevant data but also stuff that is definitely
> wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will
> be removed in QEMU 6.0).
> 
> Ideally we'd want everything to be in the main QEMU doc and don't
> even need a wiki.
> 
> On the PowerPC front, the most up-to-date docs are in the QEMU tree:
> 
> docs/system/ppc/embedded.rst 
> docs/system/ppc/powermac.rst 
> docs/system/ppc/powernv.rst  
> docs/system/ppc/prep.rst     
> docs/system/ppc/pseries.rst  
> docs/system/target-ppc.rst   
> 
> So I don't know exactly what changes you had in mind, but maybe first
> consider to update the main documentation.
> 
> On my side, I think I want do ditch all the current content and just put
> links to https://qemu.readthedocs.io/en/latest/ instead. I can take care
> of that, in which case you wouldn't need an account.
> 
> Cheers,
> 
> --
> Greg
> 
> PS:
> 
> Cedric reported that we also have a page for non-pseries
> platforms:
> 
> https://wiki.qemu.org/Documentation/Platforms/PowerPC
> 
> I'm Cc'ing some regular contributors for those platforms so
> they can  evaluate the bitrotting status of this wiki.
> 
>> Cheers,
>> 
>> Leo

Admittedly the wiki page for POWER is very unfriendly looking. I think it should be completely rewritten. 

This format should work better:

- Description
   - IBM POWER system emulator

- Build Directions
   - configure --target-list=ppc64-softmmu && make

- Suggested Command-line
   - qemu-system-ppc64 -cpu POWER9 -machine pseries -m 2G -serial mon:stdio \
	-cdrom <cd image file> -hda <hard drive image file> -boot d

- Links
   - Linux iso files
   - AIX iso ?
   - https://worthdoingbadly.com/aixqemu/
   - https://www.youtube.com/watch?v=OlajaCWvcdw - AIX 7.2 in QEMU
 
- Pictures
   - Linux running in the POWER VM
   - AIX running in the POWER VM
   - Any games running in one of the above VM's
   - Productivity software like OpenOffice in the VM

- Contacts
   - < maintainers' contact info >



If you want I could update the wiki page for you. I just would need help with verifying the above information.

Re: Editing QEMU POWER Platform wiki page

[Leonardo Augusto Guimarães Garcia]

On 2/22/21 8:01 AM, Greg Kurz wrote:
> On Thu, 18 Feb 2021 10:16:25 -0300
> Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
>
>> Hi there,
>>
>> I would like to edit the wiki page at [0] as it contains some outdated
>> information. Could anyone that has access to the wiki please help me
>> create a user so that I can edit it?
>>
>> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
>>
> Hi Leo,
>
> User creation isn't publicly available to avoid spam : only an existing
> user can create a new account.


Yeah, I saw that. That's why I asked here.


> This being said, wiki isn't the preferred
> way to expose documentation since there's no review and things ultimately
> bitrot. Page [0] you want to update is a perfect example of the mess :
> not only it contains irrelevant data but also stuff that is definitely
> wrong (e.g. 'compat' cpu property was deprecated in QEMU 5.0 and will
> be removed in QEMU 6.0).
>
> Ideally we'd want everything to be in the main QEMU doc and don't
> even need a wiki.
>
> On the PowerPC front, the most up-to-date docs are in the QEMU tree:
>
> docs/system/ppc/embedded.rst
> docs/system/ppc/powermac.rst
> docs/system/ppc/powernv.rst
> docs/system/ppc/prep.rst
> docs/system/ppc/pseries.rst
> docs/system/target-ppc.rst
>
> So I don't know exactly what changes you had in mind, but maybe first
> consider to update the main documentation.


I got here because someone pointed to me the wiki is saying that nested 
virtualization is not supported on Power, which is wrong. But I saw many 
other outdated information on the wiki as you pointed out.


>
> On my side, I think I want do ditch all the current content and just put
> links to https://qemu.readthedocs.io/en/latest/ instead. I can take care
> of that, in which case you wouldn't need an account.


I agree this would be the preferable way. Could you go ahead and do 
that, please, if others agree as well?

Cheers,

Leo


>
> Cheers,
>
> --
> Greg
>
> PS:
>
> Cedric reported that we also have a page for non-pseries
> platforms:
>
> https://wiki.qemu.org/Documentation/Platforms/PowerPC
>
> I'm Cc'ing some regular contributors for those platforms so
> they can  evaluate the bitrotting status of this wiki.
>
>> Cheers,
>>
>> Leo
>>
>>
>

Re: Editing QEMU POWER Platform wiki page

[David Gibson]

[-- Attachment #1: Type: text/plain, Size: 1229 bytes --]

On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote:
> On 2/22/21 8:01 AM, Greg Kurz wrote:
> > On Thu, 18 Feb 2021 10:16:25 -0300
> > Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
> > 
> > > Hi there,
> > > 
> > > I would like to edit the wiki page at [0] as it contains some outdated
> > > information. Could anyone that has access to the wiki please help me
> > > create a user so that I can edit it?
> > > 
> > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER
> > > 
> > Hi Leo,
> > 
> > User creation isn't publicly available to avoid spam : only an existing
> > user can create a new account.
> 
> Yeah, I saw that. That's why I asked here.

The other concerns raised in this thread are valid, but those
notwithstanding, I think it makes sense to let you update the Wiki if
you have the time and inclination.

I have a wiki account, and I know who you are, so I've created an
account for you.  Credentials to follow via private communication.

-- 
David Gibson			| I'll have my music baroque, and my code
david AT gibson.dropbear.id.au	| minimalist, thank you.  NOT _the_ _other_
				| _way_ _around_!
http://www.ozlabs.org/~dgibson

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Editing QEMU POWER Platform wiki page

[Greg Kurz]

[-- Attachment #1: Type: text/plain, Size: 1405 bytes --]

On Tue, 23 Feb 2021 15:51:19 +1100
David Gibson <david@gibson.dropbear.id.au> wrote:

> On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote:
> > On 2/22/21 8:01 AM, Greg Kurz wrote:
> > > On Thu, 18 Feb 2021 10:16:25 -0300
> > > Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
> > > 
> > > > Hi there,
> > > > 
> > > > I would like to edit the wiki page at [0] as it contains some outdated
> > > > information. Could anyone that has access to the wiki please help me
> > > > create a user so that I can edit it?
> > > > 
> > > > 0. https://wiki.qemu.org/Documentation/Platforms/POWER
> > > > 
> > > Hi Leo,
> > > 
> > > User creation isn't publicly available to avoid spam : only an existing
> > > user can create a new account.
> > 
> > Yeah, I saw that. That's why I asked here.
> 
> The other concerns raised in this thread are valid, but those
> notwithstanding, I think it makes sense to let you update the Wiki if
> you have the time and inclination.
> 

Sure, but the point is that this incentive to update documentation
would be better used in the main QEMU documentation, i.e. the
docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC
section" patch.

> I have a wiki account, and I know who you are, so I've created an
> account for you.  Credentials to follow via private communication.
> 


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: Editing QEMU POWER Platform wiki page

[Mark Cave-Ayland]

On 23/02/2021 07:59, Greg Kurz wrote:

> On Tue, 23 Feb 2021 15:51:19 +1100
> David Gibson <david@gibson.dropbear.id.au> wrote:
> 
>> On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote:
>>> On 2/22/21 8:01 AM, Greg Kurz wrote:
>>>> On Thu, 18 Feb 2021 10:16:25 -0300
>>>> Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
>>>>
>>>>> Hi there,
>>>>>
>>>>> I would like to edit the wiki page at [0] as it contains some outdated
>>>>> information. Could anyone that has access to the wiki please help me
>>>>> create a user so that I can edit it?
>>>>>
>>>>> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
>>>>>
>>>> Hi Leo,
>>>>
>>>> User creation isn't publicly available to avoid spam : only an existing
>>>> user can create a new account.
>>>
>>> Yeah, I saw that. That's why I asked here.
>>
>> The other concerns raised in this thread are valid, but those
>> notwithstanding, I think it makes sense to let you update the Wiki if
>> you have the time and inclination.
>>
> 
> Sure, but the point is that this incentive to update documentation
> would be better used in the main QEMU documentation, i.e. the
> docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC
> section" patch.

Certainly in an ideal world it would make sense to have everything held in the 
documentation, but in real life there are circumstances where having the wiki is useful.

I spend a lot of my time with people interested in emulating older machines, and for 
these people who aren't particularly technical, the manual is far too complicated: 
all they want is examples, and to know what works and what doesn't.

There was a recent thread where I think Peter discussed removing the QuickStart 
section from the documentation because it was out of date, and to me the wiki is a 
good replacement here - pretty much all of the content at 
https://wiki.qemu.org/Documentation/Platforms/PowerPC is user-generated. I also like 
the wiki organisation of Documentation/Platforms/FOO since it's easy to point people 
towards tips that will help them get started on IRC.

Another example is the SPARC page that I maintain at 
https://wiki.qemu.org/Documentation/Platforms/SPARC which mainly came about as people 
kept emailing me off-list to ask whether a particular OS will run under QEMU, and 
would then follow up by asking me for examples because the QEMU command line is 
intimidating for new users.


ATB,

Mark.

Re: Editing QEMU POWER Platform wiki page

[Greg Kurz]

On Tue, 23 Feb 2021 08:18:17 +0000
Mark Cave-Ayland <mark.cave-ayland@ilande.co.uk> wrote:

> On 23/02/2021 07:59, Greg Kurz wrote:
> 
> > On Tue, 23 Feb 2021 15:51:19 +1100
> > David Gibson <david@gibson.dropbear.id.au> wrote:
> > 
> >> On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimarães Garcia wrote:
> >>> On 2/22/21 8:01 AM, Greg Kurz wrote:
> >>>> On Thu, 18 Feb 2021 10:16:25 -0300
> >>>> Leonardo Augusto Guimarães Garcia <lagarcia@linux.ibm.com> wrote:
> >>>>
> >>>>> Hi there,
> >>>>>
> >>>>> I would like to edit the wiki page at [0] as it contains some outdated
> >>>>> information. Could anyone that has access to the wiki please help me
> >>>>> create a user so that I can edit it?
> >>>>>
> >>>>> 0. https://wiki.qemu.org/Documentation/Platforms/POWER
> >>>>>
> >>>> Hi Leo,
> >>>>
> >>>> User creation isn't publicly available to avoid spam : only an existing
> >>>> user can create a new account.
> >>>
> >>> Yeah, I saw that. That's why I asked here.
> >>
> >> The other concerns raised in this thread are valid, but those
> >> notwithstanding, I think it makes sense to let you update the Wiki if
> >> you have the time and inclination.
> >>
> > 
> > Sure, but the point is that this incentive to update documentation
> > would be better used in the main QEMU documentation, i.e. the
> > docs/system/ppc/pseries.rst file in Cedric's "docs/system: Extend PPC
> > section" patch.
> 
> Certainly in an ideal world it would make sense to have everything held in the 
> documentation, but in real life there are circumstances where having the wiki is useful.
> 

Hi Mark,

I don't say wiki isn't useful, sorry if I wasn't clear.

The current content of the POWER wiki page is extremely out-dated
and would deserve a massive rewrite. Since we don't have any
documentation for the pseries platform (e.g. supported devices)
in the main documentation, I'm just suggesting to Leo to contribute
there and then we'll link to it from the wiki. This also has the
advantage of more reviewers and it will likely be better maintained.

Then, if someone is also willing to provide extra documentation or
examples or whatever, that's perfectly fine with me. Even recommended
if it comes along an incentive to maintain that documentation as
well ! :)

Cheers,

--
Greg


> I spend a lot of my time with people interested in emulating older machines, and for 
> these people who aren't particularly technical, the manual is far too complicated: 
> all they want is examples, and to know what works and what doesn't.
> 
> There was a recent thread where I think Peter discussed removing the QuickStart 
> section from the documentation because it was out of date, and to me the wiki is a 
> good replacement here - pretty much all of the content at 
> https://wiki.qemu.org/Documentation/Platforms/PowerPC is user-generated. I also like 
> the wiki organisation of Documentation/Platforms/FOO since it's easy to point people 
> towards tips that will help them get started on IRC.
> 
> Another example is the SPARC page that I maintain at 
> https://wiki.qemu.org/Documentation/Platforms/SPARC which mainly came about as people 
> kept emailing me off-list to ask whether a particular OS will run under QEMU, and 
> would then follow up by asking me for examples because the QEMU command line is 
> intimidating for new users.
> 
> 
> ATB,
> 
> Mark.