Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
Date:   Fri, 24 Jul 2020 14:42:34 -0400
From:   Steven Rostedt <rostedt@goodmis.org>
To:     Jonathan Corbet <corbet@lwn.net>
Cc:     Peter Zijlstra <peterz@infradead.org>, linux-doc@vger.kernel.org,
        LKML <linux-kernel@vger.kernel.org>, Neil Brown <neilb@suse.de>
Subject: Re: Minor RST rant
Message-ID: <20200724144234.3227b501@oasis.local.home>
In-Reply-To: <20200724113325.44923f75@lwn.net>
References: <20200724132200.51fd2065@oasis.local.home>
        <20200724113325.44923f75@lwn.net>
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On Fri, 24 Jul 2020 11:33:25 -0600
Jonathan Corbet <corbet@lwn.net> wrote:

> Give people a tool, some of them will make more use of it than you might
> like. I do my best to push back against excessive markup (which all of the
> above qualifies as, as far as I'm concerned), but I can't really even do
> that will all that goes through my tree, much less all the docs stuff
> merged by others.
> 
> The markup in question was seemingly added by Neil; I've added him to CC
> in case he wants to comment on it.

I saw Neil as the author and should have Cc'd him.

Neil, you can read my full email here:

  https://lore.kernel.org/r/20200724132200.51fd2065@oasis.local.home

> 
> I'm not sure what to do other than to continue to push for minimal use of
> intrusive markup.

Yeah, I really didn't expect an action item to come from this. It was
just some feedback, and perhaps you can use this as an example of "too
much markup" when dealing with others.

Looking at the web page that Matthew pointed out to, does make it much
easier to read. But one still needs to remember that a large audience
of this work is still those of us that will read the plain text.

My viewer of choice is "less" ;-)

-- Steve