From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp1.linuxfoundation.org (smtp1.linux-foundation.org [172.17.192.35]) by mail.linuxfoundation.org (Postfix) with ESMTPS id C1BE4910 for ; Wed, 20 Jul 2016 12:03:58 +0000 (UTC) Received: from mail3-relais-sop.national.inria.fr (mail3-relais-sop.national.inria.fr [192.134.164.104]) by smtp1.linuxfoundation.org (Postfix) with ESMTPS id 32517160 for ; Wed, 20 Jul 2016 12:03:56 +0000 (UTC) Date: Wed, 20 Jul 2016 14:03:51 +0200 (CEST) From: Julia Lawall To: Daniel Vetter In-Reply-To: Message-ID: References: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Cc: Grant Likely , Markus Heiser , "Nikula, Jani" , "ksummit-discuss@lists.linuxfoundation.org" , Mauro Carvalho Chehab Subject: Re: [Ksummit-discuss] [TECH TOPIC] kernel documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , On Wed, 20 Jul 2016, Daniel Vetter wrote: > In 4.8 we have a shiny new kernel doc toolchain: > > https://lwn.net/Articles/692705/ > > I think it'd be great if interested parties (might be just a hallway > track) sit together and figure out how to best go about converting all > the existing docs over, and how to link it all together. I think we > pretty much have agreement that the docbook horror show needs to die, > but there's lots of other documentation that I think would be great to > include in the overall (cross-linked!) kernel docs. > > People who would be great to be there: > - Jon Corbet > - Mauro Carvalho > - Jani Nikula > - Markus Heiser > - maybe Grant Likely, he made noises about sphinx/rst too > > I think converting/polishing docs would also serve well as kernel > newbie task in opw or gsoc or wherever, that might be another > interested group. And anyone else who wants to convert over docs for > their subsystem. If anyone wants to mentor an outreachy intern on this topic, let me know. There would be a new round of internships starting in December. julia