From mboxrd@z Thu Jan 1 00:00:00 1970 From: paulmck at linux.ibm.com (Paul E. McKenney) Date: Sat, 22 Jun 2019 10:03:31 -0700 Subject: [Linux-kernel-mentees] [PATCH 1/3] Documentation: RCU: Convert RCU basic concepts to ReST In-Reply-To: <20190622085411.3c1692c2@lwn.net> References: <20190622070133.GA7149@rYz3n> <20190622085411.3c1692c2@lwn.net> Message-ID: <20190622170331.GR26519@linux.ibm.com> List-Id: On Sat, Jun 22, 2019 at 08:54:11AM -0600, Jonathan Corbet wrote: > On Sat, 22 Jun 2019 02:01:33 -0500 > Jiunn Chang wrote: > > > Convert RCU basic concepts and add TOC tree hook. > > > > Signed-off-by: Jiunn Chang > > 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 From mboxrd@z Thu Jan 1 00:00:00 1970 From: paulmck@linux.ibm.com (Paul E. McKenney) Date: Sat, 22 Jun 2019 10:03:31 -0700 Subject: [Linux-kernel-mentees] [PATCH 1/3] Documentation: RCU: Convert RCU basic concepts to ReST In-Reply-To: <20190622085411.3c1692c2@lwn.net> References: <20190622070133.GA7149@rYz3n> <20190622085411.3c1692c2@lwn.net> Message-ID: <20190622170331.GR26519@linux.ibm.com> List-Id: Content-Type: text/plain; charset="UTF-8" Message-ID: <20190622170331.5Z18q1r2f2p7kb1DN-D0GlrEC58l2IzOygr9IAsA1hw@z> On Sat, Jun 22, 2019 at 08:54:11AM -0600, Jonathan Corbet wrote: > On Sat, 22 Jun 2019 02:01:33 -0500 > Jiunn Chang wrote: > > > Convert RCU basic concepts and add TOC tree hook. > > > > Signed-off-by: Jiunn Chang > > 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