From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752425AbcHIIWN (ORCPT ); Tue, 9 Aug 2016 04:22:13 -0400 Received: from bombadil.infradead.org ([198.137.202.9]:38952 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751194AbcHIIWK (ORCPT ); Tue, 9 Aug 2016 04:22:10 -0400 Date: Tue, 9 Aug 2016 01:22:09 -0700 From: Christoph Hellwig To: Jani Nikula Cc: Christoph Hellwig , Jonathan Corbet , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools Message-ID: <20160809082209.GA7553@infradead.org> References: <20160808233502.16950-1-corbet@lwn.net> <20160808233502.16950-4-corbet@lwn.net> <20160809080736.GA15461@infradead.org> <87lh06xsk9.fsf@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87lh06xsk9.fsf@intel.com> User-Agent: Mutt/1.6.1 (2016-04-27) X-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org. See http://www.infradead.org/rpr.html Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Aug 09, 2016 at 11:19:50AM +0300, Jani Nikula wrote: > On Tue, 09 Aug 2016, Christoph Hellwig wrote: > > The ugly format is a major regression over a proper simple text > > file. What's the point? > > Major regression? Please be reasonable. > > I think the changes are rather small, and it's a fair compromise between > a simple text file and one that can be used to generate pretty > documentation [1]. It's a lot less pretty to read - it look like a cat threw up to be specific. The point of the Document is to read it quickly in the kernel tree. If you want fancy websites write a separate document. > [1] http://static.lwn.net/kerneldoc/dev-tools/sparse.html And I wouldn't exactly call that pretty. There is no value add over a simple text file here, and it requires a browser to not look ugly instead of a text editor, which is a giant usablity regression.