The HBase one has come along nicely, though I think it needs to be repositioned in the rest of our documentation[1]. We also have a guide specific to documentation contributions[2].
If we already have consensus on how we want contributions to look (or if folks want a proposal to start with), I can work on making a NiFi tailored contribution guide this weekend. I'd recommend going with the label "beginner". The HBase community went through some discussion about the matter, if you're interested in the reasoning[3]. It might be helpful to scope what make a ticket approachable for newcomers. Cribbing from myself in that email thread, I look for * Have been vetted as desired and non-controversial * Are low priority so they need not be done under time pressure * Offer a view of some (small-ish) part of the code base * Require minimal information about the overall project outside of the section to be fixed [1]: http://hbase.apache.org/book/developer.html [2]: http://hbase.apache.org/book/appendix_contributing_to_documentation.html [3]: http://search-hadoop.com/m/DHED43re96 On Wed, Dec 10, 2014 at 11: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) > > > -- Sean
