From: Jonathan Corbet <corbet@lwn.net>
To: Peter Zijlstra <peterz@infradead.org>
Cc: "Mike Snitzer" <snitzer@redhat.com>,
"Mauro Carvalho Chehab" <mchehab+samsung@kernel.org>,
"Linux Doc Mailing List" <linux-doc@vger.kernel.org>,
"Mauro Carvalho Chehab" <mchehab@infradead.org>,
linux-kernel@vger.kernel.org,
"Johannes Berg" <johannes@sipsolutions.net>,
"Kurt Schwemmer" <kurt.schwemmer@microsemi.com>,
"Logan Gunthorpe" <logang@deltatee.com>,
"Bjorn Helgaas" <bhelgaas@google.com>,
"Alasdair Kergon" <agk@redhat.com>,
dm-devel@redhat.com, "Kishon Vijay Abraham I" <kishon@ti.com>,
"Rob Herring" <robh+dt@kernel.org>,
"Mark Rutland" <mark.rutland@arm.com>,
"Bartlomiej Zolnierkiewicz" <b.zolnierkie@samsung.com>,
"David Airlie" <airlied@linux.ie>,
"Daniel Vetter" <daniel@ffwll.ch>,
"Maarten Lankhorst" <maarten.lankhorst@linux.intel.com>,
"Maxime Ripard" <maxime.ripard@bootlin.com>,
"Sean Paul" <sean@poorly.run>, "Ning Sun" <ning.sun@intel.com>,
"Ingo Molnar" <mingo@redhat.com>,
"Will Deacon" <will.deacon@arm.com>,
"Alan Stern" <stern@rowland.harvard.edu>,
"Andrea Parri" <andrea.parri@amarulasolutions.com>,
"Boqun Feng" <boqun.feng@gmail.com>,
"Nicholas Piggin" <npiggin@gmail.com>,
"David Howells" <dhowells@redhat.com>,
"Jade Alglave" <j.alglave@ucl.ac.uk>,
"Luc Maranget" <luc.maranget@inria.fr>,
"Paul E. McKenney" <paulmck@linux.ibm.com>,
"Akira Yokosawa" <akiyks@gmail.com>,
"Daniel Lustig" <dlustig@nvidia.com>,
"David S. Miller" <davem@davemloft.net>,
"Andreas Färber" <afaerber@suse.de>,
"Manivannan Sadhasivam" <manivannan.sadhasivam@linaro.org>,
"Cornelia Huck" <cohuck@redhat.com>,
"Farhan Ali" <alifm@linux.ibm.com>,
"Eric Farman" <farman@linux.ibm.com>,
"Halil Pasic" <pasic@linux.ibm.com>,
"Martin Schwidefsky" <schwidefsky@de.ibm.com>,
"Heiko Carstens" <heiko.carstens@de.ibm.com>,
"Harry Wei" <harryxiyou@gmail.com>,
"Alex Shi" <alex.shi@linux.alibaba.com>,
"Jerry Hoemann" <jerry.hoemann@hpe.com>,
"Wim Van Sebroeck" <wim@linux-watchdog.org>,
"Guenter Roeck" <linux@roeck-us.net>,
"Thomas Gleixner" <tglx@linutronix.de>,
"Borislav Petkov" <bp@alien8.de>,
"H. Peter Anvin" <hpa@zytor.com>,
x86@kernel.org, "Russell King" <linux@armlinux.org.uk>,
"Tony Luck" <tony.luck@intel.com>,
"Fenghua Yu" <fenghua.yu@intel.com>,
"James E.J. Bottomley" <James.Bottomley@HansenPartnership.com>,
"Helge Deller" <deller@gmx.de>,
"Yoshinori Sato" <ysato@users.sourceforge.jp>,
"Rich Felker" <dalias@libc.org>, "Guan Xuetao" <gxt@pku.edu.cn>,
"Jens Axboe" <axboe@kernel.dk>,
"Greg Kroah-Hartman" <gregkh@linuxfoundation.org>,
"Rafael J. Wysocki" <rafael@kernel.org>,
"Arnd Bergmann" <arnd@arndb.de>, "Matt Mackall" <mpm@selenic.com>,
"Herbert Xu" <herbert@gondor.apana.org.au>,
"Corey Minyard" <minyard@acm.org>,
"Sumit Semwal" <sumit.semwal@linaro.org>,
"Linus Walleij" <linus.walleij@linaro.org>,
"Bartosz Golaszewski" <bgolaszewski@baylibre.com>,
"Darren Hart" <dvhart@infradead.org>,
"Andy Shevchenko" <andy@infradead.org>,
"Stuart Hayes" <stuart.w.hayes@gmail.com>,
"Jaroslav Kysela" <perex@perex.cz>,
"Alex Williamson" <alex.williamson@redhat.com>,
"Kirti Wankhede" <kwankhede@nvidia.com>,
"Christoph Hellwig" <hch@lst.de>,
"Marek Szyprowski" <m.szyprowski@samsung.com>,
"Robin Murphy" <robin.murphy@arm.com>,
"Steffen Klassert" <steffen.klassert@secunet.com>,
"Kees Cook" <keescook@chromium.org>,
"Emese Revfy" <re.emese@gmail.com>,
"James Morris" <jmorris@namei.org>,
"Serge E. Hallyn" <serge@hallyn.com>,
linux-wireless@vger.kernel.org, linux-pci@vger.kernel.org,
devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org,
linux-fbdev@vger.kernel.org, tboot-devel@lists.sourceforge.net,
linux-arch@vger.kernel.org, netdev@vger.kernel.org,
linux-arm-kernel@lists.infradead.org, linux-s390@vger.kernel.org,
kvm@vger.kernel.org, linux-watchdog@vger.kernel.org,
linux-ia64@vger.kernel.org, linux-parisc@vger.kernel.org,
linux-sh@vger.kernel.org, sparclinux@vger.kernel.org,
linux-block@vger.kernel.org, linux-crypto@vger.kernel.org,
openipmi-developer@lists.sourceforge.net,
linaro-mm-sig@lists.linaro.org, linux-gpio@vger.kernel.org,
platform-driver-x86@vger.kernel.org,
iommu@lists.linux-foundation.org, linux-mm@kvack.org,
kernel-hardening@lists.openwall.com,
linux-security-module@vger.kernel.org
Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst
Date: Tue, 23 Apr 2019 10:30:53 -0600 [thread overview]
Message-ID: <20190423103053.07cf2149@lwn.net> (raw)
In-Reply-To: <20190423130132.GT4038@hirez.programming.kicks-ass.net>
On Tue, 23 Apr 2019 15:01:32 +0200
Peter Zijlstra <peterz@infradead.org> wrote:
> But yes, I have 0 motivation to learn or abide by rst. It simply doesn't
> give me anything in return. There is no upside, only worse text files :/
So I believe it gives even you one thing in return: documentation that is
more accessible for both readers and authors. More readable docs should
lead to more educated developers who understand the code better. More
writable docs will bring more people in to help to improve them. The
former effect has been reported in the GPU community, where they say that
the quality of submissions has improved along with the docs. The latter
can be observed in the increased number of people working on the docs
overall, something that Linus noted in the 5.1-rc1 announcement.
Hopefully that's worth something :)
Thanks,
jon
next prev parent reply other threads:[~2019-04-23 16:31 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <cover.1555938375.git.mchehab+samsung@kernel.org>
2019-04-22 13:28 ` [PATCH v2 78/79] docs: sysctl: convert to ReST Mauro Carvalho Chehab
[not found] ` <cda57849a6462ccc72dcd360b30068ab6a1021c4.1555938376.git.mchehab+samsung@kernel.org>
2019-04-22 16:37 ` [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Logan Gunthorpe
2019-04-23 8:31 ` Peter Zijlstra
2019-04-23 12:55 ` Mike Snitzer
2019-04-23 13:01 ` Peter Zijlstra
2019-04-23 13:21 ` Mike Snitzer
2019-04-23 16:30 ` Jonathan Corbet [this message]
2019-04-23 17:11 ` Peter Zijlstra
2019-04-23 17:20 ` Borislav Petkov
2019-04-23 17:53 ` Jonathan Corbet
2019-04-23 18:21 ` Peter Zijlstra
[not found] ` <20190423171944.7ac6db54@coco.lan>
2019-04-23 20:34 ` Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190423103053.07cf2149@lwn.net \
--to=corbet@lwn.net \
--cc=James.Bottomley@HansenPartnership.com \
--cc=afaerber@suse.de \
--cc=agk@redhat.com \
--cc=airlied@linux.ie \
--cc=akiyks@gmail.com \
--cc=alex.shi@linux.alibaba.com \
--cc=alex.williamson@redhat.com \
--cc=alifm@linux.ibm.com \
--cc=andrea.parri@amarulasolutions.com \
--cc=andy@infradead.org \
--cc=arnd@arndb.de \
--cc=axboe@kernel.dk \
--cc=b.zolnierkie@samsung.com \
--cc=bgolaszewski@baylibre.com \
--cc=bhelgaas@google.com \
--cc=boqun.feng@gmail.com \
--cc=bp@alien8.de \
--cc=cohuck@redhat.com \
--cc=dalias@libc.org \
--cc=daniel@ffwll.ch \
--cc=davem@davemloft.net \
--cc=deller@gmx.de \
--cc=devicetree@vger.kernel.org \
--cc=dhowells@redhat.com \
--cc=dlustig@nvidia.com \
--cc=dm-devel@redhat.com \
--cc=dri-devel@lists.freedesktop.org \
--cc=dvhart@infradead.org \
--cc=farman@linux.ibm.com \
--cc=fenghua.yu@intel.com \
--cc=gregkh@linuxfoundation.org \
--cc=gxt@pku.edu.cn \
--cc=harryxiyou@gmail.com \
--cc=hch@lst.de \
--cc=heiko.carstens@de.ibm.com \
--cc=herbert@gondor.apana.org.au \
--cc=hpa@zytor.com \
--cc=iommu@lists.linux-foundation.org \
--cc=j.alglave@ucl.ac.uk \
--cc=jerry.hoemann@hpe.com \
--cc=jmorris@namei.org \
--cc=johannes@sipsolutions.net \
--cc=keescook@chromium.org \
--cc=kernel-hardening@lists.openwall.com \
--cc=kishon@ti.com \
--cc=kurt.schwemmer@microsemi.com \
--cc=kvm@vger.kernel.org \
--cc=kwankhede@nvidia.com \
--cc=linaro-mm-sig@lists.linaro.org \
--cc=linus.walleij@linaro.org \
--cc=linux-arch@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-block@vger.kernel.org \
--cc=linux-crypto@vger.kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fbdev@vger.kernel.org \
--cc=linux-gpio@vger.kernel.org \
--cc=linux-ia64@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=linux-parisc@vger.kernel.org \
--cc=linux-pci@vger.kernel.org \
--cc=linux-s390@vger.kernel.org \
--cc=linux-security-module@vger.kernel.org \
--cc=linux-sh@vger.kernel.org \
--cc=linux-watchdog@vger.kernel.org \
--cc=linux-wireless@vger.kernel.org \
--cc=linux@armlinux.org.uk \
--cc=linux@roeck-us.net \
--cc=logang@deltatee.com \
--cc=luc.maranget@inria.fr \
--cc=m.szyprowski@samsung.com \
--cc=maarten.lankhorst@linux.intel.com \
--cc=manivannan.sadhasivam@linaro.org \
--cc=mark.rutland@arm.com \
--cc=maxime.ripard@bootlin.com \
--cc=mchehab+samsung@kernel.org \
--cc=mchehab@infradead.org \
--cc=mingo@redhat.com \
--cc=minyard@acm.org \
--cc=mpm@selenic.com \
--cc=netdev@vger.kernel.org \
--cc=ning.sun@intel.com \
--cc=npiggin@gmail.com \
--cc=openipmi-developer@lists.sourceforge.net \
--cc=pasic@linux.ibm.com \
--cc=paulmck@linux.ibm.com \
--cc=perex@perex.cz \
--cc=peterz@infradead.org \
--cc=platform-driver-x86@vger.kernel.org \
--cc=rafael@kernel.org \
--cc=re.emese@gmail.com \
--cc=robh+dt@kernel.org \
--cc=robin.murphy@arm.com \
--cc=schwidefsky@de.ibm.com \
--cc=sean@poorly.run \
--cc=serge@hallyn.com \
--cc=snitzer@redhat.com \
--cc=sparclinux@vger.kernel.org \
--cc=steffen.klassert@secunet.com \
--cc=stern@rowland.harvard.edu \
--cc=stuart.w.hayes@gmail.com \
--cc=sumit.semwal@linaro.org \
--cc=tboot-devel@lists.sourceforge.net \
--cc=tglx@linutronix.de \
--cc=tony.luck@intel.com \
--cc=will.deacon@arm.com \
--cc=wim@linux-watchdog.org \
--cc=x86@kernel.org \
--cc=ysato@users.sourceforge.jp \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox