Re: [PATCH v2 00/21] Convert hwmon documentation to ReST

From: Guenter Roeck <linux@roeck-us.net>
To: Jonathan Corbet <corbet@lwn.net>
Cc: linux-hwmon@vger.kernel.org, Jean Delvare <jdelvare@suse.com>,
	linux-aspeed@lists.ozlabs.org,
	Linux Doc Mailing List <linux-doc@vger.kernel.org>,
	Andrew Jeffery <andrew@aj.id.au>,
	Sudeep Holla <sudeep.holla@arm.com>,
	Liviu Dudau <liviu.dudau@arm.com>,
	linux-kernel@vger.kernel.org,
	Mauro Carvalho Chehab <mchehab@infradead.org>,
	Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>,
	Paul Mackerras <paulus@samba.org>, Joel Stanley <joel@jms.id.au>,
	Mauro Carvalho Chehab <mchehab+samsung@kernel.org>,
	linuxppc-dev@lists.ozlabs.org,
	linux-arm-kernel@lists.infradead.org
Subject: Re: [PATCH v2 00/21] Convert hwmon documentation to ReST
Date: Fri, 12 Apr 2019 20:09:16 -0700	[thread overview]
Message-ID: <f900adea-d231-c00d-847c-33e66e79ea30@roeck-us.net> (raw)
In-Reply-To: <20190412100451.6fe49de7@lwn.net>

On 4/12/19 9:04 AM, Jonathan Corbet wrote:
> On Thu, 11 Apr 2019 14:07:31 -0700
> Guenter Roeck <linux@roeck-us.net> wrote:
> 
>>> While nobody does such split, IMHO, the best would be to keep the
>>> information outside Documentation/admin-guide. But hey! You're
>>> the Doc maintainer. If you prefer to move, I'm perfectly fine
>>> with that.
>>>    
>>
>> Same here, but please don't move the files which are kernel facing only.
> 
> Well, let's step back and think about this.  Who is the audience for
> these documents?  That will tell us a lot about where they should really
> be.
> 
> What I would prefer to avoid is the status quo where *everything* is in
> the top-level directory, and where documents are organized for the
> convenience of their maintainers rather than of their readers.  But
> sometimes I feel like I'm alone in that desire...:)
> 

The big real-world question is: Is the series good enough for you to accept,
or do you expect some level of user/kernel separation ?

Guenter