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.

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