Messages in this thread | | | Date | Tue, 21 Apr 2020 18:39:15 -0400 | From | "Theodore Y. Ts'o" <> | Subject | Re: [PATCH v2 08/29] docs: filesystems: convert configfs.txt to ReST |
| |
On Tue, Apr 21, 2020 at 07:23:37PM +0200, Christoph Hellwig wrote: > 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.
FWIW, I consider the rst transformations to be an improvement, even when reading them as a text mode.
- Ted
| |