Personally I'm an absolute NiFi beginner and I'd start by walking down commit history in the NiFi repo to get a sense of the code and where the project is making changes. As long as a commit references a JIRA identifier, I can pull up the issue for background. Perhaps embedding JIRA URLs in the commit message would be useful for newcomers.
On the HBase project we'd point people to http://hbase.apache.org/book/developer.html, where the first section is "Getting Involved", with a link to a JIRA search for our beginner issues. Accumulo's "Get Involved" page has something similar at http://accumulo.apache.org/get_involved.html. The Phoenix project has a simple "Contributing" page for newcomers http://phoenix.apache.org/contributing.html . (And looks like some fixups are needed after that recent re-skin.) On Wed, Dec 10, 2014 at 9:20 PM, Joe Witt <[email protected]> wrote: > Thanks Andrew. Definitely will do that. Thinking through the perspective > of a newcomer is where that thread about trace-ability between a Jira issue > and code commits came in as well. Not only is that helpful for > committers/pmc folks but also for new contributors who can better follow > the lifecycle of a ticket to code, to review/commentary, and so on. > > Do you have a good example page that talks about the contribution/newcomer > onboarding for your projects? I've seen the accumulo, kafka ones thus > far. Will look around some more as well. > > On Thu, Dec 11, 2014 at 12:15 AM, Andrew Purtell <[email protected]> > wrote: > > > Wow, really great to see the flood of JIRA issues, NiFi is off and > running! > > > > A suggestion: Consider if some of the filed issues are approachable to > > newcomers. If so, add a label like "newbie" or "beginner", and tag these > > issues with that label. When putting up on the website your How To > > Contribute documentation, you could point potential new contributors at a > > JIRA search on this label. > > > > -- > > Best regards, > > > > - Andy > > > > Problems worthy of attack prove their worth by hitting back. - Piet Hein > > (via Tom White) > > > -- Best regards, - Andy Problems worthy of attack prove their worth by hitting back. - Piet Hein (via Tom White)
