Upgrade to Pro — share decks privately, control downloads, hide ads and more …

TFW your country funds Open Source development

TFW your country funds Open Source development

The summary and the lesson learned on contributing to Read The Docs while building Docs Italia for the Italian Digital Transformation Team. Talk presented at VoxxedDays Milano 2019.

Riccardo Magliocchetti

April 13, 2019
Tweet

More Decks by Riccardo Magliocchetti

Other Decks in Programming

Transcript

  1. TFW YOUR COUNTRY FUNDS
    TFW YOUR COUNTRY FUNDS
    OPEN SOURCE DEVELOPMENT
    OPEN SOURCE DEVELOPMENT
    RICCARDO MAGLIOCCHETTI
    RICCARDO MAGLIOCCHETTI
    VOXXEDDAYS MILANO 2019
    VOXXEDDAYS MILANO 2019

    View Slide

  2. WHOAMI
    WHOAMI
    PYTHONISTA, SOFTWARE DEVELOPER, CONSULTANT
    OSS CONTRIBUTOR

    View Slide

  3. ITALIAN DIGITAL
    ITALIAN DIGITAL
    TRANSFORMATION TEAM
    TRANSFORMATION TEAM
    MAKE PUBLIC SERVICES FOR CITIZENS AND BUSINESSES
    ACCESSIBLE IN AN EASY MANNER

    View Slide

  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

    View Slide

  5. DOCS ITALIA

    View Slide

  6. READ THE DOCS

    View Slide

  7. WHY A FORK?
    WHY A FORK?

    View Slide

  8. UPSTREAM
    UPSTREAM
    CONTRIBUTIONS
    CONTRIBUTIONS

    View Slide

  9. 33 PULL REQUESTS
    33 PULL REQUESTS
    22 MERGED
    10 CLOSED
    1 OPEN

    View Slide

  10. 22 PR MERGED
    22 PR MERGED
    10 BUGFIXES
    6 I18N
    6 CODE CLEANUPS

    View Slide

  11. 1 REGRESSION :)
    1 REGRESSION :)

    View Slide

  12. ANSIBLE AUTOMATION
    ANSIBLE AUTOMATION

    View Slide

  13. 0 NEW FEATURES
    0 NEW FEATURES

    View Slide

  14. 1 FEATURE FAIL
    1 FEATURE FAIL

    View Slide

  15. LESSONS
    LESSONS
    LEARNED
    LEARNED

    View Slide

  16. BUILD TRUST
    BUILD TRUST
    WITH UPSTREAM
    WITH UPSTREAM
    BE PART OF THE COMMUNITY

    View Slide

  17. A FORK IS
    A FORK IS
    A LONG LIVED BRANCH
    A LONG LIVED BRANCH
    FIX UPSTREAM, LESS DELTA DOWNSTREAM
    CONTRIBUTING TO OPEN SOURCE IS PART OF THE JOB

    View Slide

  18. CONVENIENCE > PURITY
    CONVENIENCE > PURITY
    OVERRIDE INSTEAD OF PATCH
    CONFIGURATION FTW

    View Slide

  19. SYNC WITH UPSTREAM:
    SYNC WITH UPSTREAM:
    REBASE VS MERGE
    REBASE VS MERGE

    View Slide

  20. CONCLUSIONS
    CONCLUSIONS
    NOT ALL PROJECT FORKS ARE BAD :)
    YOU CAN DELIVER VALUE
    WHILE
    CONTRIBUTING BACK TO OPEN SOURCE

    View Slide

  21. THANKS!
    THANKS!
    GITHUB.COM/ITALIA
    GITHUB.COM/XRMX
    SPEAKERDECK.COM/XRMX
    @RMISTAKEN
    MENODIZERO.IT

    View Slide