Thanks for starting a list Adam :)

On Tue, May 14, 2019 at 8:07 AM Adam Spiers <aspiers@suse.com> wrote:
Kendall Nelson <kennelson11@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)