From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.2 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_SANE_2 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5A9ABC433DB for ; Tue, 23 Feb 2021 16:54:58 +0000 (UTC) Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id E75C464E60 for ; Tue, 23 Feb 2021 16:54:57 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org E75C464E60 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=kaod.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Received: from localhost ([::1]:56182 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lEaxc-0001eo-UI for qemu-devel@archiver.kernel.org; Tue, 23 Feb 2021 11:54:56 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:44516) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lEawN-0008ST-OX for qemu-devel@nongnu.org; Tue, 23 Feb 2021 11:53:41 -0500 Received: from 4.mo51.mail-out.ovh.net ([188.165.42.229]:51976) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lEawI-0000Za-CY for qemu-devel@nongnu.org; Tue, 23 Feb 2021 11:53:39 -0500 Received: from mxplan5.mail.ovh.net (unknown [10.109.143.210]) by mo51.mail-out.ovh.net (Postfix) with ESMTPS id 8AF83263B70; Tue, 23 Feb 2021 17:53:30 +0100 (CET) Received: from kaod.org (37.59.142.98) by DAG8EX1.mxp5.local (172.16.2.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2106.2; Tue, 23 Feb 2021 17:53:29 +0100 Authentication-Results: garm.ovh; auth=pass (GARM-98R002b5e4d627-de63-488d-a8f5-862f1e847b85, 6F2917FB5EF69EFB637F8DE19110E4015BA123FD) smtp.auth=groug@kaod.org X-OVh-ClientIp: 78.197.208.248 Date: Tue, 23 Feb 2021 17:53:28 +0100 From: Greg Kurz To: Mark Cave-Ayland Subject: Re: Editing QEMU POWER Platform wiki page Message-ID: <20210223175328.35685d15@bahia.lan> In-Reply-To: References: <91874f1e-4b14-5fb1-f1ae-1225938df759@linux.ibm.com> <20210222120138.31f313c9@bahia.lan> <3c3fc3f0-afb8-1012-eaf7-11ecbe146025@linux.ibm.com> <20210223085910.6928135a@bahia.lan> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Originating-IP: [37.59.142.98] X-ClientProxiedBy: DAG8EX1.mxp5.local (172.16.2.71) To DAG8EX1.mxp5.local (172.16.2.71) X-Ovh-Tracer-GUID: dcf4e921-d1d6-4804-b7d6-caf180bcd197 X-Ovh-Tracer-Id: 3677470573108894057 X-VR-SPAMSTATE: OK X-VR-SPAMSCORE: -100 X-VR-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgeduledrkeehgdelfecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfqggfjpdevjffgvefmvefgnecuuegrihhlohhuthemucehtddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpeffhffvuffkjghfofggtgfgihesthhqredtredtjeenucfhrhhomhepifhrvghgucfmuhhriicuoehgrhhouhhgsehkrghougdrohhrgheqnecuggftrfgrthhtvghrnhepteeffedvkeejkedvhfduudelheejgeegteeufefhheetgeejgffggedtteefveffnecuffhomhgrihhnpehqvghmuhdrohhrghenucfkpheptddrtddrtddrtddpfeejrdehledrudegvddrleeknecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmohguvgepshhmthhpqdhouhhtpdhhvghlohepmhigphhlrghnhedrmhgrihhlrdhovhhhrdhnvghtpdhinhgvtheptddrtddrtddrtddpmhgrihhlfhhrohhmpehgrhhouhhgsehkrghougdrohhrghdprhgtphhtthhopegtlhhgsehkrghougdrohhrgh Received-SPF: pass client-ip=188.165.42.229; envelope-from=groug@kaod.org; helo=4.mo51.mail-out.ovh.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: QEMU devel list , Programmingkid , QEMU PPC devel list , Cedric Le Goater , lagarcia@br.ibm.com, David Gibson Errors-To: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Sender: "Qemu-devel" On Tue, 23 Feb 2021 08:18:17 +0000 Mark Cave-Ayland wrote: > On 23/02/2021 07:59, Greg Kurz wrote: >=20 > > On Tue, 23 Feb 2021 15:51:19 +1100 > > David Gibson wrote: > >=20 > >> On Mon, Feb 22, 2021 at 06:18:08PM -0300, Leonardo Augusto Guimar=C3= =A3es Garcia wrote: > >>> On 2/22/21 8:01 AM, Greg Kurz wrote: > >>>> On Thu, 18 Feb 2021 10:16:25 -0300 > >>>> Leonardo Augusto Guimar=C3=A3es Garcia wrot= e: > >>>> > >>>>> Hi there, > >>>>> > >>>>> I would like to edit the wiki page at [0] as it contains some outda= ted > >>>>> 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 exist= ing > >>>> 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. > >> > >=20 > > 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. >=20 > Certainly in an ideal world it would make sense to have everything held i= n the=20 > documentation, but in real life there are circumstances where having the = wiki is useful. >=20 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 machin= es, and for=20 > these people who aren't particularly technical, the manual is far too com= plicated:=20 > all they want is examples, and to know what works and what doesn't. >=20 > There was a recent thread where I think Peter discussed removing the Quic= kStart=20 > section from the documentation because it was out of date, and to me the = wiki is a=20 > good replacement here - pretty much all of the content at=20 > https://wiki.qemu.org/Documentation/Platforms/PowerPC is user-generated. = I also like=20 > the wiki organisation of Documentation/Platforms/FOO since it's easy to p= oint people=20 > towards tips that will help them get started on IRC. >=20 > Another example is the SPARC page that I maintain at=20 > https://wiki.qemu.org/Documentation/Platforms/SPARC which mainly came abo= ut as people=20 > kept emailing me off-list to ask whether a particular OS will run under Q= EMU, and=20 > would then follow up by asking me for examples because the QEMU command l= ine is=20 > intimidating for new users. >=20 >=20 > ATB, >=20 > Mark.