Open Stack

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.

-- 
Doug