TFW your country funds Open Source development

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.

61ba6f6b1fb82707b9344259f74a81b3?s=128

Riccardo Magliocchetti

June 16, 2019
Tweet

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