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

JabRef and Open Source Development

Oliver Kopp
September 30, 2022

JabRef and Open Source Development

Oliver Kopp

September 30, 2022
Tweet

More Decks by Oliver Kopp

Other Decks in Research

Transcript

  1. JabRef and Open Source Development
    Dr. Oliver Kopp
    Chairman JabRef e.V.
    Microsoft Learn Student Ambassadors | Emerging Technologies Month | Professional Development Event
    2022-05-20

    View Slide

  2. 2
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    Overview on JabRef
    1
    Agenda

    View Slide

  3. 3
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    JabRef as Open Source project
    JabRef Demonstration
    Background: LaTeX and BibTeX
    Overview on JabRef
    1
    Agenda

    View Slide

  4. 4
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    JabRef as Open Source project
    JabRef Demonstration
    Background: LaTeX and BibTeX
    Overview on JabRef
    1
    Agenda

    View Slide

  5. 5
    LaTeX and BibTeX as tooling for researchers
    .tex file
    TeXStudio as editor
    (others are possible)
    .bib file
    Scientific text References
    JabRef as editor
    (others are possible)

    View Slide

  6. 6
    LaTeX Compilation (simplified with focus on BibTeX)
    .tex file .bib file
    .bst file
    bibtex
    .bbl file
    pdftex
    .pdf file
    (specifies how each BibTeX entry
    should converted to LaTeX)
    @Article{Binz2009,
    author = {Tobias Binz and Gerd Breiter and
    Frank Leymann and Thomas Spatzier},
    journal = {IEEE Internet Computing},
    title = {{Portable Cloud Services Using TOSCA}},
    year = {2012},
    issn = {1089-7801},
    month = may,
    number = {03},
    pages = {80--85},
    volume = {16},
    doi = {10.1109/mic.2012.43},
    publisher = {IEEE Computer Society},
    }

    View Slide

  7. 7
    Example Result – and Challenges
     How to find related work?
     Externally (in the internet)
     Internally (in the .bib file)
     How to include related work in the
    paper?
     How to ensure that the list of related
    work has the correct information?

    View Slide

  8. 8
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    JabRef as Open Source project
    JabRef Demonstration
    Background: LaTeX and BibTeX
    Overview on JabRef
    1
    Agenda

    View Slide

  9. 9
    Demonstration: JabRef as BibTeX-based Literature Management Tool
    .tex file
    TeXStudio as editor
    (others are possible)
    .bib file
    Scientific text references
    JabRef as editor
    (others are possible)

    View Slide

  10. 10
    JabRef’s Main Features
     Collect
     Online Search
     PDF Files
     Organize
     Grouping
     Fixing of data
     Cite
     BibTeX
     Cite-as-you-
    write
     Share
     .bib in git

    View Slide

  11. 11
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    JabRef as Open Source project
    JabRef Demonstration
    Background: LaTeX and BibTeX
    Overview on JabRef
    1
    Agenda

    View Slide

  12. 12
    History of JabRef – Commits
    It all started 2003:
    Morten Alver und Nizar Batada
    I joined in the
    project
    PhD students of
    University of
    Bamberg
    joined;
    move from
    sourceforge
    to GitHub
    Start of non-profit
    organization
    “JabRef e.V.”
    Student project
    at University of
    Stuttgart
    2014

    View Slide

  13. 13
    JabRef Open Source State as of 2022-05-19
     2,581 GitHub Stars
     17,115 Commits
     48 Releases
     431 Contributors (2018: 140 Contributors)
     5193 closed pull requests
     3286 closed issues
     10 main developers (as freetime project)
     ~ 50,000 lines of code, ~41% test coverage
    Source: https://codecov.io/github/JabRef/jabref

    View Slide

  14. 14
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    Overview on JabRef
    1
    Agenda

    View Slide

  15. 15
    Why is JabRef open source?
     Background: Open sourcing is a licensing model of a software
     Free redistribution [1]
     Source code availability [1]
     Mass adoption
     Faster development speed by enabling others to contribute
     Offer students a fun project giving something back
    to the whole student community
    [1] Open Source Initiative: Open Source Definition https://opensource.org/osd

    View Slide

  16. 16
    Maintainers (mainly) do their open source work because of impact
    Background: first-ever survey of open source maintainers;
    2021; 400 responses [1]
     46% of open-source project maintainers are not paid at all
    The top three reasons maintainers enjoy their work are
     “Making a positive impact on the world” (71%),
     “Allowing me to fulfill a need for creative, challenging, and/or enjoyable
    work” (63%)
     “Getting to work on projects that matter to me” (59%)
    [1] https://tidelift.com/subscription/the-tidelift-maintainer-survey

    View Slide

  17. 17
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    Overview on JabRef
    1
    Agenda

    View Slide

  18. 18
    JabRef as Software Engineering Education Object
     Observation
     Teaching Programming starts with simple projects
     Teaching continues with “large” projects
     Missing: Medium-sized project with “simple” functionality
     Aim of JabRef as project
     High-quality student education due to real-world tooling and real-world code base
     Sustainability of student works: No more thrown-away solved exercises: They now
    are incorporated in a real-world product
     Free universities to provision infrastructure
     Offer a point to get visibility for both students and research groups
    https://devdocs.jabref.org/teaching

    View Slide

  19. 19
    Make Code Reviews Explicit as Required Steps
    https://devdocs.jabref.org/teaching

    View Slide

  20. 20
    GenderMag method to fix gender-inclusiveness “bugs”
     The core of the GenderMag Method is a gender-specialized cognitive
    walkthrough
     GenderMag Personas:
     “representatives” of a range of users, but only…
     …from the perspective of 5 cognitive facets [simplified]:
     Motivations: learning when needing to vs. exploration of new things
     Computer self-efficacy
     Risk averseness with tech: exploring new vs. following new paths
     Information processing style: Acting upon the first option vs. depth first vs.
    understanding the whole problem
     Tech learning style (tinkering): By Process or by Tinkering
    More information: https://gendermag.org/foundations.php
    Abi Pat
    Tim

    View Slide

  21. 21
    Example of a GenderMag recommendation
    Source: http://gendermag.org/dc/

    View Slide

  22. 22
    Contribution page on JabRef

    View Slide

  23. 23
    Lack of social interaction as main obstacle for newcomers
    Source:
    I. Steinmacher et al: “A systematic
    literature review on the barriers faced by
    newcomers to open source software
    projects” –
    DOI:10.1016/j.infsof.2014.11.001

    View Slide

  24. 24
    Q&A
    4
    Attracting and Managing Contributions on JabRef
    3
    On Open Source Development
    2
    Overview on JabRef
    1
    Agenda

    View Slide

  25. 25
    Q&A: JabRef as Leading BibTeX-based Literature Management Tool
     Collect
     Online Search
     PDF Files
     Organize
     Grouping
     Fixing of data
     Cite
     BibTeX
     Cite-as-you-
    write
     Share
     .bib in git

    View Slide