openstack/training-guides
Code Issues Proposed changes

upstream cleanup 19

Browse Source 
Syntax and formatting cleanup for Sphinx/Hieroglyph.

Change-Id: Ia892e1844d7bc5e3e33d56236cc8bbb083945b25
This commit is contained in:
Matjaz Pancur 2015-04-06 01:27:55 +02:00 committed by Pranav Salunke
parent 36cd7475d8
commit f3300a09c5
1 changed files with 3 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
doc/upstream-training/source/19-training-contribution-process.rst
View File

@ -2,14 +2,10 @@
Overview of the contribution process
====================================
.. rst-class:: colright
OpenStack Upstream Training
---------------------------
<teacher name>
<date>
----
| <teacher name>
| <date>
Project pulse
=============
@ -20,9 +16,6 @@ Project pulse
- When was the last update?
- etc.
----
Who's behind it?
==================
@ -30,9 +23,6 @@ Who's behind it?
- Companies
- What's their incentive?
----
Project as social groups
=========================
@ -41,8 +31,6 @@ Project as social groups
- Corporate driven
- Volunteers
----
Assess your approach
====================
@ -51,8 +39,6 @@ Assess your approach
- Habits: online relationships?
- Acknowledge the language barrier
----
Engage immediately
==================
@ -60,8 +46,6 @@ Engage immediately
- Get your nick/e-mail known
- Mingle
----
Be engaged with your network
============================
@ -71,8 +55,6 @@ Be engaged with your network
- Ask about their contribution experience
- Ask if they know someone with similar experiences
----
Smaller tasks
=============
@ -80,8 +62,6 @@ Smaller tasks
- Splitting a task
- Seeking agreement on the split
----
Choosing a question
===================
@ -89,8 +69,6 @@ Choosing a question
- Find a solution that needs to be agreed upon
- Ask the question and propose your solution
----
Code of conduct
===============
@ -102,8 +80,6 @@ Code of conduct
- Step down considerately
- Respect the election process
----
Disagree
========
@ -112,8 +88,6 @@ Disagree
- No flamewars
- No enemies
----
Understanding the conventions
=============================
@ -122,8 +96,6 @@ Understanding the conventions
- Read the actual code and the actual documentation
- Apply them very diligently
----
Explain what you do
===================
@ -132,8 +104,6 @@ Explain what you do
- What the work does
- Each choice made must have a rationale
----
Prepare the backport
====================
@ -141,8 +111,6 @@ Prepare the backport
- Think about backporting
- Twist the contribution to ease backporting
----
Local and upstream
==================
@ -150,22 +118,16 @@ Local and upstream
- Stable version
- In house version
----
Good workflow
=============
.. image:: ./_assets/19-01-goodworkflow.png
----
Bad workflow
============
.. image:: ./_assets/19-02-badworkflow.png
----
Quantify the delta
==================
@ -173,8 +135,6 @@ Quantify the delta
- Compare
- Analyze the reasons for an increased delta
----
Speeding the acceptance
=======================
@ -183,8 +143,6 @@ Speeding the acceptance
- Communication
- Getting attention
----
Timeframe
=========
@ -192,8 +150,6 @@ Timeframe
- Ask for attention weekly
- Try to get attention at least four times
----
Building karma
==============
@ -202,8 +158,6 @@ Building karma
- Fix the documentation
- Answer questions
----
Parallelizing
=============
@ -211,8 +165,6 @@ Parallelizing
- Karma missions
- Learning about the project
----
From easy to difficult
======================
@ -222,12 +174,9 @@ From easy to difficult
- Discussing the architecture
- Influence the project governance
----
Archive and collect
===================
- Log IM channels
- Keep links to e-mail archives
- Choose one place to gather all information