[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