The summary and the lesson learned on contributing to Read The Docs while building Docs Italia. Talk presented at Python Torino #1 Meetup.
TFW YOUR COUNTRY FUNDSTFW YOUR COUNTRY FUNDSOPEN SOURCE DEVELOPMENTOPEN SOURCE DEVELOPMENTRICCARDO MAGLIOCCHETTIRICCARDO MAGLIOCCHETTI
View Slide
WHOAMIWHOAMIPYTHONISTA, SOFTWARE DEVELOPER, CONSULTANTOSS CONTRIBUTOR
ITALIAN DIGITALITALIAN DIGITALTRANSFORMATION TEAMTRANSFORMATION TEAMMAKE PUBLIC SERVICES FOR CITIZENS AND BUSINESSESACCESSIBLE IN AN EASY MANNER
DOCS ITALIA TEAMDOCS ITALIA TEAMALBERTO TORINDAVIDE PORROVECCHIOFIORELLA DE LUCAFRANCESCO OCCHIPINTIFRANCESCO ZAIAIACOPO SPALLETTILEONARDO CAVALLUCCIPAOLO ROMOLINIRICCARDO MAGLIOCCHETTI
DOCS ITALIA
READ THE DOCS
WHY A FORK?WHY A FORK?
UPSTREAMUPSTREAMCONTRIBUTIONSCONTRIBUTIONS
33 PULL REQUESTS33 PULL REQUESTS22 MERGED9 CLOSED2 OPEN
22 PR MERGED22 PR MERGED10 BUGFIXES6 I18N6 CODE CLEANUPS
1 REGRESSION :)1 REGRESSION :)
ANSIBLE AUTOMATIONANSIBLE AUTOMATIONTHANKS YAKKY!
0 NEW FEATURES0 NEW FEATURES
1 FEATURE FAIL1 FEATURE FAIL
LESSONSLESSONSLEARNEDLEARNED
BUILD TRUSTBUILD TRUSTWITH UPSTREAMWITH UPSTREAM
FIX UPSTREAM,FIX UPSTREAM,LESS DELTA DOWNSTREAMLESS DELTA DOWNSTREAM
CONVENIENCE > PURITYCONVENIENCE > PURITYOVERRIDE INSTEAD OF PATCH:MAKE THINGS CONFIGURABLEDJANGO REUSABLE APPS FTW!
A FORK ISA FORK ISA LONG LIVED BRANCHA LONG LIVED BRANCH
REBASE VS MERGEREBASE VS MERGE
CONCLUSIONSCONCLUSIONSNOT ALL PROJECT FORKS ARE BAD :)UPSTREAM WORK IS AN INVESTMENTOPEN SOURCE PROJECTS AS STAKEHOLDERS?
THANKS!THANKS!GITHUB.COM/ITALIAGITHUB.COM/XRMXSPEAKERDECK.COM/XRMX@RMISTAKENMENODIZERO.IT