From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matt Porter Subject: Re: [RFC PATCH 0/5] DT binding documents using text markup Date: Tue, 8 Sep 2015 10:28:29 -0400 Message-ID: <20150908142829.GH17267@beef> References: <1440739433-6799-1-git-send-email-mporter@konsulko.com> <20150828171323.GA24203@beef> <55E5E1E2.6040607@gmail.com> Mime-Version: 1.0 Return-path: Content-Disposition: inline In-Reply-To: Sender: devicetree-spec-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org List-ID: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit To: Tim Bird Cc: Frank Rowand , Rob Herring , Devicetree List , Devicetree Spec List , Grant Likely , Rob Herring , Mark Rutland , Pantelis Antoniou , Behan Webster On Tue, Sep 01, 2015 at 11:03:50AM -0700, Tim Bird wrote: > On Tue, Sep 1, 2015 at 10:35 AM, Frank Rowand wrote: > > On 9/1/2015 10:14 AM, Tim Bird wrote: > >> On Fri, Aug 28, 2015 at 10:13 AM, Matt Porter wrote: > > > > < snip > > > > >>> > >>> But to answer your question, if we get a format I'll do > >>> conversions and hope I'm not alone. > >> > >> I'm sure others will help out. I will, and I'm pretty sure we can get > >> some conversion sprints set up at conferences (I know I can set aside > >> some time or resources at ELC in the spring - it might be too late for > >> ELCE in October to set up a scheduled block of time, but we can start > >> getting the word out.) As I said in my other e-mail, one doesn't have > >> to be a kernel coder to do this, and the conversions should be pretty > >> straight-forward. > >> -- Tim > >> > > > > A conversion sprint at ELCE sounds like a good idea if we can find a > > good time to schedule it. I can help, so there will be at least two > > of us who can help people as they encounter issues. > > Even if we don't find a block of time, we can do something like > announce a "contest", ask people to do something in their spare time, > and find some way to get them a raffle ticket if they submit a patch > with a conversion. Then hold an extra prize drawing during the > closing session, with just those raffle tickets, and give someone a > nice award for contributing. Of course, there's always the adage that > you should be careful what you measure and reward... We don't want a > flood of crappy conversions, with a time constraint on the review. > I'll think some more about this. An alternative would be to have a > contest announced ahead of the event, with enough time for people to > submit and get reviewed. > > By the way - I presume the new docs will replace the existing ones, > but I could imagine wanting to have them live side-by-side > temporarily. Any thoughts on this? Will file name or location > changes be allowed during the conversion? Good question. As a starting point I simply changed the file extension and they live in the same directory structure with the .txt versions. I can't think of an advantage to moving locations or file names initially. Certainly some file names could use improvement but changing them introduces confusion. -Matt