On Mon, Jun 12, 2017 at 9:39 AM, Coty Sutherland <csuth...@redhat.com> wrote: > On Mon, Jun 12, 2017 at 3:20 AM, Violeta Georgieva <violet...@apache.org> > wrote: >> 2017-06-11 23:57 GMT+03:00 Coty Sutherland <csuth...@redhat.com>: >>> >>> On Sun, Jun 11, 2017 at 4:20 PM, Violeta Georgieva <violet...@apache.org> >> wrote: >>> > Hi Coty, >>> > >>> > 2017-06-02 17:50 GMT+03:00 Coty Sutherland <csuth...@redhat.com>: >>> >> >>> >> On Fri, Jun 2, 2017 at 10:27 AM, Violeta Georgieva < >> violet...@apache.org> >>> > wrote: >>> >> > Hi, >>> >> > >>> >> > 2017-05-31 6:07 GMT+03:00 Coty Sutherland <csuth...@redhat.com>: >>> >> >> >>> >> >> Hi all, >>> >> >> >>> >> >> I've been thinking about things that we could do for Tomcat to help >>> >> >> bring in new contributors and to be more appealing to new >> developers. >>> >> >> Right now we have http://tomcat.apache.org/getinvolved.html which >> has >>> >> >> a few bullet points and links to documentation, which is a bit >> verbose, >>> >> >> about how to contribute to an Apache project. We also have the wiki >>> >> >> (https://wiki.apache.org/tomcat/FrontPage), which mentions nothing >>> >> >> about contributing. Bugzilla is a bit daunting for newcomers >> (thought >>> >> >> we did create the "Beginners" tag to help identify some BZs for new >>> >> >> folks to work on) too. I've been looking around for some ideas on >> how >>> > to >>> >> >> make it easier for new people to contribute after having some >>> >> >> conversations with friends about contributing to Tomcat and found >> some >>> >> >> interesting examples other projects are using to help bring new >> people >>> >> >> in, such as https://wiki.gnome.org/Newcomers (which is my favorite) >>> >> >> and https://fedoraproject.org/wiki/Join. Obviously Tomcat isn't as >>> >> >> large of a project as those, but it does have multiple places for >>> >> >> people to contribute (Documentation, Patches, FAQ, wiki, etc) which >>> >> >> could use different skill sets. This site >>> >> >> http://whatcanidoforfedora.org/en would be really cool to implement, >>> >> >> but at the ASF level I think (Tomcat isn't complex enough to warrant >>> >> >> that, is it?). >>> >> >> >>> >> >> Anyway, the point of this email is really just to say that we should >>> >> >> take some cues from other projects and try and develop a solid entry >>> >> >> ramp to help entice new developers :) What does everyone else think? >>> >> > >>> >> > One thing that might help from my point of view is to provide >> README.md >>> > and >>> >> > CONTRIBUTING.md for those who are working with GitHub replications of >>> > the >>> >> > repository. It is convenient to have the contribution's instruction >>> >> > directly in the root of the repository. >>> >> > e.g. >>> >> > https://github.com/apache/jmeter/blob/trunk/README.md >>> >> > https://github.com/apache/flink/blob/master/README.md >>> >> > >>> >> > >>> >> > What do you think? >>> >> >>> >> Oh yeah. That's a great idea! I was just catching up on the thread and >>> >> was trying to think of a way a way to let github users know what >>> >> committers are doing with their PRs to get them committed (a README is >>> >> obvious). I think that adding some transparency there may help them >>> >> understand some issues that could cause latency. >>> >> >>> > >>> > If you didn't start with README.md I can prepare some initial version. >>> >>> I hadn't started yet, but I intended to. It's on my TODO list :) >> >> Ok I'll leave it to you ;)
OK, published (what I think is) a solid first draft :) Now that something is there, I'm sure everyone has ideas on what it needs to be. Feel free to edit as needed. I tried to make the tone a bit jovial so that it's a bit less daunting and more welcoming for new folks. Cheers, > Sounds good. I'm working on it now and should be committing the two > files shortly in trunk for review. After I get some positive feedback > then I'll port to 7, 8, and 8.5. I was going to try and make them > generic documents, however since the branches are all in separate git > repos anyway I'm adding some version specific information. > >> Violeta >> >>> If you want, you can put something up and I'll edit it as soon as I make >>> time. >>> >>> > Regards, >>> > Violeta >>> > >>> >> > Regards, >>> >> > Violeta >>> >> >> >>> >> >> >>> >> >> Thanks, >>> >> >> Coty >>> >> >>> >> --------------------------------------------------------------------- >>> >> To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org >>> >> For additional commands, e-mail: dev-h...@tomcat.apache.org >>> >> >>> >>> --------------------------------------------------------------------- >>> To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org >>> For additional commands, e-mail: dev-h...@tomcat.apache.org >>> --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
