Re: [PATCH v2 08/29] docs: filesystems: convert configfs.txt to ReST

From: Christoph Hellwig
Date: Tue Apr 21 2020 - 13:23:43 EST


On Tue, Apr 21, 2020 at 10:02:23AM -0700, Matthew Wilcox wrote:
> On Tue, Apr 21, 2020 at 06:55:34PM +0200, Christoph Hellwig wrote:
> > NAK, this makes the document significantly harder to read.
>
> Really? It reads more easily to me in the new format. Enclosing
> section headers in [] is really weird.

It wasn't entirely uncommon, but that's not really the point. The
Problem is all the weird ".." or "::" annotations that really kill
the flow, or things like "|copy|" that have no reason to exist.