On Fri, Nov 30, 2018 at 08:42:23PM +0000, Chris Mason wrote:

I think the bar for changing the documentation/comments should be improvement in the clarity or approachability of whatever is being changed.

This patch set is kind of like Linus sitting at kernel summit with a sign that says "Free Hugs". Kind of confusing, and really unlikely to make anyone involved happier about working on the kernel.

Jarkko, making things clearer and more approachable is absolutely worth the time if you're interested, but I think it'll mean larger and more individualized changes to these files.

Fully 110% agree.

/Jarkko