[First Contact] [SIG] Summit/Forum + PTG Summary
Hello All! Here's a super short summary of the going's on WRT the First Contact SIG. There were plenty of other relevant sessions, but this email summarizes the ones that we were directly responsible for. Summit Session + PTG -------------------------------- The Meet & Greet and the PTG session went similarly. We had a few new faces come in and introduce themselves. Most of the new faces were operators from various companies which was cool that they wanted to get engaged. Members of the SIG introduced themselves and answered any questions that we could. 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. 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. Etherpad from those discussions: https://etherpad.openstack.org/p/new-contribs-state-and-deduplication -Kendall Nelson (diablo_rojo)
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
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)
Kendall Nelson <kennelson11@gmail.com> wrote:
Thanks for starting a list Adam :)
[snipped]
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.
OK, this is now all in a new etherpad: https://etherpad.openstack.org/p/onboarding-docs-mvp Anyone else got any suggestions?
participants (2)
-
Adam Spiers
-
Kendall Nelson