[tc] The future of the "Help most needed" list

Ghanshyam Mann gmann at ghanshyammann.com
Tue Feb 12 08:27:11 UTC 2019


---- On Fri, 08 Feb 2019 01:07:33 +0900 Doug Hellmann <doug at doughellmann.com> wrote ---- 
 > Ghanshyam Mann <gmann at ghanshyammann.com> writes: 
 >  
 > >  ---- On Thu, 07 Feb 2019 21:42:53 +0900 Doug Hellmann <doug at doughellmann.com> wrote ----  
 > >  > Thierry Carrez <thierry at openstack.org> writes:  
 > >  >   
 > >  > > Doug Hellmann wrote:  
 > >  > >> [...]  
 > >  > >> During the Train series goal discussion in Berlin we talked about having  
 > >  > >> a goal of ensuring that each team had documentation for bringing new  
 > >  > >> contributors onto the team. Offering specific mentoring resources seems  
 > >  > >> to fit nicely with that goal, and doing it in each team's repository in  
 > >  > >> a consistent way would let us build a central page on docs.openstack.org  
 > >  > >> to link to all of the team contributor docs, like we link to the user  
 > >  > >> and installation documentation, without requiring us to find a separate  
 > >  > >> group of people to manage the information across the entire community.  
 > >  > >  
 > >  > > I'm a bit skeptical of that approach.  
 > >  > >  
 > >  > > Proper peer mentoring takes a lot of time, so I expect there will be a   
 > >  > > limited number of "I'll spend significant time helping you if you help   
 > >  > > us" offers. I don't envision potential contributors to browse dozens of   
 > >  > > project-specific "on-boarding doc" to find them. I would rather   
 > >  > > consolidate those offers on a single page.  
 > >  > >  
 > >  > > So.. either some magic consolidation job that takes input from all of   
 > >  > > those project-specific repos to build a nice rendered list... Or just a   
 > >  > > wiki page ?  
 > >  > >  
 > >  > > --   
 > >  > > Thierry Carrez (ttx)  
 > >  > >  
 > >  >   
 > >  > A wiki page would be nicely lightweight, so that approach makes some  
 > >  > sense. Maybe if the only maintenance is to review the page periodically,  
 > >  > we can convince one of the existing mentorship groups or the first  
 > >  > contact SIG to do that.  
 > > 
 > > Same can be achieved If we have a single link on doc.openstack.org or contributor guide with 
 > > top section "Help-wanted" with subsection of each project specific help-wanted. project help 
 > > wanted subsection can be build from help wanted section from project contributor doc.  
 > > 
 > > That way it is easy for the project team to maintain their help wanted list. Wiki page can  
 > > have the challenge of prioritizing and maintain the list.   
 > > 
 > > -gmann 
 > > 
 > >  >   
 > >  > --   
 > >  > Doug  
 >  
 > Another benefit of using the wiki is that SIGs and pop-up teams can add 
 > their own items. We don't have a good way for those groups to be 
 > integrated with docs.openstack.org right now. 

Nice point about SIG. pop-up teams are more of volunteer only which might have less chance
to make an entry in this list. My main concern with wiki is, it easily ( and maybe most of them )
gets obsolete. Especially in this case where technical ownership is distributed.  

-gmann

 >  
 > --  
 > Doug 
 >  
 > 





More information about the openstack-discuss mailing list