openstack/training-guides
Code Issues Proposed changes
training-guides/doc/upstream-training/source/website/upstream-details.rst
Ildiko Vancsa b99ac59747 [upstream] Clean up and update the details page 
Change-Id: I530054929f1cfc6c81b8421375db8e05b5d6b299
2017-03-19 13:27:57 +01:00

12 KiB
Raw Blame History

OpenStack Upstream Institute Class Details

Introduction

With over 2000 developers from 80 different companies worldwide, OpenStack is one of the largest collaborative software-development projects. Because of its size, it is characterized by a huge diversity in social norms and technical conventions. Attending a live class to get an insight of how the community operates and to learn about the insights and best practices can significantly increase the speed at which newcomers are successful at integrating their own roadmap into that of the OpenStack project.

We've designed a training program to provide an interactive environment to newcomers where they can learn they ways of collaborating with our community. We are relying on the principles of open collaboration and describe and show how the 'Four Opens' work in OpenStack in practice.

The training has a modular structre by which it gives room to attendees with different job roles.

For example if you are a project or program manager it is very important for you to understand how the OpenStack releases are structured in order to be able to plan the roadmap for the product you are responsible for. You might also be interested in participating in Working Groups to actively participate in and influence the community in you areas of interest. The training helps you to find the information entry points you need.

If you are a developer we help you to find your way into the community to get your bug fix or feature accepted in the OpenStack project in a minimum amount of time.

The live one and a half day class teaches the students how to navigate the intricacies of the project's technical tools and social interactions and shows how they can collaborate with the community and find their place in the ecosystem.

After the training students have the possibility to sign up for a longer term mentoring to further stregthen the skills they've learnt during the training.

Objectives

  • Understand the OpenStack release cycle to the level of being able to sychronize and integrate it with your product's roadmap
  • Get to know the technical tools
  • Understand the OpenStack contribution workflow and social norms
  • Know where to find information, where and how to get help if needed
  • Be able to identify and start a task (bug fix, feature design and implementation, Working Group activity and so forth)

Target Audience

  • Developers/Software Engineers/Architects
  • System administrators
  • Project/Program managers/Product owners

Prerequisites to attend the class

  • Being able to read and write English at a technical level

Recommendations to become an active community member

  • For code and/or documentation contributions having at least 40% of your work time dedicate to the project, be it through programming or through interacting with the community
  • For Working Group participation having at least 15-20% of your work time allocated for community activities
  • If contributing code, being technically proficient enough to carry out simple bug fixes in the project
  • If contributing documentation, being able to produce documents in the project's chosen infrastructure

Duration

  • Face-to-face section: 1.5 days

Infrastructure

We are providing a virtual machine with the necessary tools pre-installed in it. For further information about the system requirements on it please see the ref: prepare-environment section.

Course Outline

  • Day 1: Introduction
  • Day 1: How OpenStack is made
  • Day 1: Learn and practice Git, Gerrit, IRC
  • Day 2: The theory of contribution
  • Day 2: Deep dive sessions

First day

Introduction

How OpenStack is made (3h including 1h30 exercises)

Workflow of an OpenStack contribution and tools (3h including 2h exercises)

Second day

The Contribution Process (1 hour)

Overview of the contribution process

  • Take the pulse of the project
  • Figure out who's behind it
  • Determine the project's social groups
  • Assess your approach
  • Engage immediately
  • Play with your network
  • Perform the smaller tasks
  • Choose a question
  • Familiarize yourself with the code of conduct
  • Understand the conventions
  • Explain what you do
  • Prepare the backport
  • Learn what's local and what's upstream
  • Learn what distinguishes good work flow from bad work flow
  • Quantify the delta
  • Speed up the acceptance
  • Determine the time frame
  • Maximize karma
  • Work in parallel
  • Archive and collect

Complete index in slide format only