git.net

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[First Contact] [SIG] Summit/Forum + PTG Summary


Thanks for starting a list Adam :)

On Tue, May 14, 2019 at 8:07 AM Adam Spiers <aspiers at suse.com> wrote:

> Kendall Nelson <kennelson11 at gmail.com> wrote:
> >Forum Session (Welcoming New Contributors State of the Union and
> >Deduplication of Efforts)
> >-----------------------------------------------------------------------------------------------------------------------------
>
> >
> >The biggest things that came out of this session were discussion about
> >recording of onboarding sessions and a community goal of improving
> >contributor documentation.
> >
> >Basically, we have never had the onboarding sessions recorded but if we
> >could tt would really help new contributors even if they might get a
> little
> >stale before we are able to record new ones.
>
> +1: slightly out of date info is still usually better than none.
>
> This other mail thread in the last hour jogged my memory on some of the
> other
> details we discussed in this session:
>
> http://lists.openstack.org/pipermail/openstack-discuss/2019-May/006224.html
>
> >During that chat, we learned
> >that Octavia does somewhat regular calls in whch they do onboarding for
> new
> >contributors. I have asked for an outline to help encourage other
> projects
> >to do similar.
> >
> >As for per project contributor documentation, some projects have it and
> >some don't.  Some projects have it and its incomplete. bauzas volunteered
> >to do an audit of which projects have it and which don't and to propose a
> >community goal for it. As a part of that, we should probably decide on a
> >list of bare minimum things to include.
>
> Few things off the top of my head:
>
>    - Architectural overview
>
>    - Quickstart for getting the code running in the simplest form
>      (even if this is just "use devstack with these parameters")
>
>    - Overview of all the project's git repos, and the layout of the files
>      in each
>
>    - How to run the various types of tests
>
>    - How to find some easy dev tasks to get started with
>

I would also add what task trackers they use and the tags they use as an
extension of your last bullet point.

Also might include info about if they use specs or bps or neither for new
features.

-Kendall (diablo_rojo)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-discuss/attachments/20190514/d9c7ca80/attachment.html>