TFW your country funds Open Source development

During 2018 I’ve been a contractor for the Italian Digital Transformation Team working on docs.italia.it (Docs Italia), an Open Source platform to collect and share the Public Administration documentation. We didn't write Docs Italia from scratch though but built it on top of Read The Docs, the leading documentation platform for Python packages. We saved a lot of work by leveraging another open source project. Cool! Still Open Source software does not write itself and we managed to contribute back some value to the upstream project. In this talk I'll share what we did and what we learned.

Transcript

1. TFW YOUR COUNTRY FUNDS TFW YOUR COUNTRY FUNDS OPEN SOURCE DEVELOPMENT OPEN SOURCE DEVELOPMENT RICCARDO MAGLIOCCHETTI RICCARDO MAGLIOCCHETTI PYLONDINIUM 2019 PYLONDINIUM 2019
2. WHOAMI WHOAMI PYTHONISTA, SOFTWARE DEVELOPER, CONSULTANT OSS CONTRIBUTOR
3. ITALIAN DIGITAL ITALIAN DIGITAL TRANSFORMATION TEAM TRANSFORMATION TEAM MAKE PUBLIC SERVICES FOR CITIZENS AND BUSINESSES ACCESSIBLE IN AN EASY MANNER
4. DOCS ITALIA TEAM DOCS ITALIA TEAM ALBERTO TORIN DAVIDE PORROVECCHIO FIORELLA DE LUCA FRANCESCO OCCHIPINTI FRANCESCO ZAIA IACOPO SPALLETTI LEONARDO CAVALLUCCI PAOLO ROMOLINI RICCARDO MAGLIOCCHETTI
5. DOCS ITALIA
6. READ THE DOCS
7. WE FORKED READ THE DOCS WE FORKED READ THE DOCS A PROJECT FORK HAPPENS WHEN [...] CREATING A DISTINCT AND SEPARATE PIECE OF SOFTWARE. [...] NOT MERELY A DEVELOPMENT BRANCH, BUT ALSO A SPLIT IN THE DEVELOPER COMMUNITY. WIKIPEDIA
8. WHY A FORK? WHY A FORK?
9. UPSTREAM UPSTREAM CONTRIBUTIONS CONTRIBUTIONS
10. 33 PULL REQUESTS 33 PULL REQUESTS 22 MERGED 11 CLOSED
11. 22 PR MERGED 22 PR MERGED 10 BUGFIXES 6 I18N 6 CODE CLEANUPS
12. 1 REGRESSION :) 1 REGRESSION :)
13. ANSIBLE ANSIBLE DEPLOY AUTOMATION DEPLOY AUTOMATION
14. 0 NEW FEATURES 0 NEW FEATURES
15. 1 FEATURE FAIL 1 FEATURE FAIL
16. LESSONS LESSONS LEARNED LEARNED
17. BUILD TRUST BUILD TRUST WITH UPSTREAM WITH UPSTREAM BE PART OF THE COMMUNITY
18. A FORK IS A FORK IS A LONG LIVED BRANCH A LONG LIVED BRANCH FIX UPSTREAM, LESS DELTA DOWNSTREAM
19. CONTRIBUTING TO OSS CONTRIBUTING TO OSS IS PART OF THE JOB IS PART OF THE JOB
20. CONVENIENCE > PURITY CONVENIENCE > PURITY OVERRIDE INSTEAD OF PATCH CONFIGURATION FTW
21. SYNC WITH UPSTREAM: SYNC WITH UPSTREAM: REBASE VS MERGE REBASE VS MERGE
22. CONCLUSIONS CONCLUSIONS NOT ALL PROJECT FORKS ARE BAD :) YOU CAN DELIVER VALUE WHILE CONTRIBUTING BACK TO OPEN SOURCE
23. THANKS! THANKS! GITHUB.COM/ITALIA GITHUB.COM/XRMX SPEAKERDECK.COM/XRMX @RMISTAKEN MENODIZERO.IT