A couple of years ago I had the same concerns. I got pushback on messing with the TLD pages (perhaps more accurately there were so many strong opinions it wasn't worth the argument, plus the task is daunting to say the least). Instead I started trying to create "signposts" into our dense TLD pages.
That work was done as part of ComDev, see community.apache.org My plan was to identify the important stuff. Write a para or two on it and then deep link into the TLD fire hose. Secretly I hoped that one day the ComDev pages would become the TLD pages and the fire hose would disappear deep into the reference section of our site. Anyway, the point is that I agree with you. You might choose to build on the ComDev stuff. You might choose to tackle the TLD stuff head on. Whatever you do I'm sure it will be worthwhile. Ross Sent from my Windows Phone ________________________________ From: Igor Galić<mailto:i.ga...@brainsware.org> Sent: 11/25/2014 7:53 AM To: dev<mailto:dev@community.apache.org> Subject: (improving) New Committers Info Fellow Humans, this weekend the trafficserver team added a new committer, which means that i sent out this wonderful template with a link to https://www.apache.org/dev/committers.html for further information. Who of you remembers getting that email? and who remembers reading it, and weeping softly, because you had no idea what's going on, and how you'll ever stand up to the impossible standards of the demi-gods that just stretched out a finger to you? or is that just me? oh, well… well, one way or another, these walls of text, and i'm using the plural here, because in trafficserver's case we also invite people to the PMC at the same time, which means they also get: https://www.apache.org/dev/pmc.html are profoundly unhelpful, out-dated, and to quote rich: 07:40 <+rbowen> igalic: Very discouraging and overwhelming. 07:40 <+rbowen> Almost all of the first block of questions are ... pointless 07:40 <+rbowen> What is an infrathon? Really? That's what a committer needs to know? 07:41 <+rbowen> I find these pages that are just a list of questions to be exactly the wrong way to go about it. 07:41 <+rbowen> I don't even know what the questions mean, as a new committer, let alone care about the answers. 07:42 <+rbowen> Seems that the version control questions should go first anyways. 07:42 <+rbowen> When do I need to use svn lock? 07:42 <+rbowen> um ... what's svn lock? 07:42 <+rbowen> Ah, the answer is "don't do that" 07:42 <+rbowen> Brilliant. 07:42 <+rbowen> This page makes me cry. But! There's a silver-lining on the horizon here: 07:43 <+rbowen> On the bright side, nobody is ever going to find these documents on their own. So I'd like to solicit some help fixing these pages to contain useful information… -- Igor Galić Tel: +43 (0) 664 886 22 883 Mail: i.ga...@brainsware.org URL: http://brainsware.org/ GPG: 8716 7A9F 989B ABD5 100F 4008 F266 55D6 2998 1641
