<div dir="ltr"><div dir="ltr"><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small">Thanks for starting a list Adam :)</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, May 14, 2019 at 8:07 AM Adam Spiers <<a href="mailto:aspiers@suse.com">aspiers@suse.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Kendall Nelson <<a href="mailto:kennelson11@gmail.com" target="_blank">kennelson11@gmail.com</a>> wrote: <br>
>Forum Session (Welcoming New Contributors State of the Union and <br>
>Deduplication of Efforts) <br>
>----------------------------------------------------------------------------------------------------------------------------- <br>
><br>
>The biggest things that came out of this session were discussion about <br>
>recording of onboarding sessions and a community goal of improving <br>
>contributor documentation. <br>
><br>
>Basically, we have never had the onboarding sessions recorded but if we <br>
>could tt would really help new contributors even if they might get a little <br>
>stale before we are able to record new ones. <br>
<br>
+1: slightly out of date info is still usually better than none. <br>
<br>
This other mail thread in the last hour jogged my memory on some of the other <br>
details we discussed in this session: <br>
<br>
<a href="http://lists.openstack.org/pipermail/openstack-discuss/2019-May/006224.html" rel="noreferrer" target="_blank">http://lists.openstack.org/pipermail/openstack-discuss/2019-May/006224.html</a> <br>
<br>
>During that chat, we learned <br>
>that Octavia does somewhat regular calls in whch they do onboarding for new <br>
>contributors. I have asked for an outline to help encourage other projects <br>
>to do similar. <br>
><br>
>As for per project contributor documentation, some projects have it and <br>
>some don't.  Some projects have it and its incomplete. bauzas volunteered <br>
>to do an audit of which projects have it and which don't and to propose a <br>
>community goal for it. As a part of that, we should probably decide on a <br>
>list of bare minimum things to include. <br>
<br>
Few things off the top of my head: <br>
<br>
   - Architectural overview<br>
<br>
   - Quickstart for getting the code running in the simplest form<br>
     (even if this is just "use devstack with these parameters")<br>
<br>
   - Overview of all the project's git repos, and the layout of the files<br>
     in each<br>
<br>
   - How to run the various types of tests<br>
<br>
   - How to find some easy dev tasks to get started with<br></blockquote><div><br></div><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small">I would also add what task trackers they use and the tags they use as an extension of your last bullet point. </div><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small"><br></div><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small">Also might include info about if they use specs or bps or neither for new features. </div><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small"><br></div><div class="gmail_default" style="font-family:tahoma,sans-serif;font-size:small">-Kendall (diablo_rojo)</div></div></div>