Open Stack

 ---- 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 
 >  
 >