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 full-size slide

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

    View full-size slide

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

    View full-size 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 full-size slide

  5. READ THE DOCS

    View full-size slide

  6. WHY A FORK?
    WHY A FORK?

    View full-size slide

  7. UPSTREAM
    UPSTREAM
    CONTRIBUTIONS
    CONTRIBUTIONS

    View full-size slide

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

    View full-size slide

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

    View full-size slide

  10. 1 REGRESSION :)
    1 REGRESSION :)

    View full-size slide

  11. ANSIBLE AUTOMATION
    ANSIBLE AUTOMATION

    View full-size slide

  12. 0 NEW FEATURES
    0 NEW FEATURES

    View full-size slide

  13. 1 FEATURE FAIL
    1 FEATURE FAIL

    View full-size slide

  14. LESSONS
    LESSONS
    LEARNED
    LEARNED

    View full-size slide

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

    View full-size slide

  16. 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 full-size slide

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

    View full-size slide

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

    View full-size slide

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

    View full-size slide

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

    View full-size slide