[Linux-kernel-mentees] [PATCH 1/3] Documentation: RCU: Convert RCU basic concepts to ReST

[Paul E. McKenney]

On Sat, Jun 22, 2019 at 08:54:11AM -0600, Jonathan Corbet wrote:
> On Sat, 22 Jun 2019 02:01:33 -0500
> Jiunn Chang <c0d1n61at3 at gmail.com> wrote:
> 
> > Convert RCU basic concepts and add TOC tree hook.
> > 
> > Signed-off-by: Jiunn Chang <c0d1n61at3 at gmail.com>
> 
> A few overall comments...
> 
>  - Hopefully Paul is OK with converting these documents.  If not, Paul,
>    now seems like the time to complain :)

No complaints here!

>  - It's good to have a cover letter on a multi-part patch set like this
>    describing the overall project.  It's also important to copy patches to
>    a public list.  At a minimum, linux-doc would be a good place; I'd
>    suggest linux-kernel as well - it doesn't get enough email and people
>    get lonely there.

Heh!  For RCU documentation patches, please also CC rcu at vger.kernel.org.

>  - (The part that people get mad at me about): we should think about
>    whether this should remain a top-level directory.  I would argue for
>    putting it into the core-api manual, but others may disagree.

Let's worry about that separately.

> Thanks for working to improve our docs!  In this case, the conversion
> itself looks good.

I will do a build and check within the next few days, and will more
carefully review your next version of this patch series.

							Thanx, Paul