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

Adam Spiers aspiers at suse.com
Tue May 14 15:06:57 UTC 2019

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: 


>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

More information about the openstack-discuss mailing list