Skip to content
This repository has been archived by the owner on Aug 1, 2023. It is now read-only.

Latest commit

 

History

History
433 lines (302 loc) · 10.5 KB

content.md

File metadata and controls

433 lines (302 loc) · 10.5 KB

Context

preCICE is a free C++ library that couples your simulations

Usually in RSE

  • Developers are also users
  • Domain experts

Our case

  • We are not the target users
  • Software/methods specialists
  • Munich, Stuttgart, Eindhoven

Why build a community?


Don't get users

  • "It's just a prototype"
  • "They will steal my work"
  • No plans to continue
  • No time to support them

Get users

  • Feedback & contributions
  • Citations (strong delay)
  • Stronger proposals
  • Industry funding
  • Recruiting
  • Career opportunities
Community dream: Users help each other

It's motivating!

After the amount of support I received from this community, I am switching to opensource for every one of my needs.

@nithinadidela on Discourse


Get your first users


Don't do

  • Develop unimportant features
  • Convince developers of similar tools
  • Go only to conferences in your field

Do

  • Add missing components
  • Ready-to-use packages
  • Easy documentation
  • Simple tutorials
  • Go to domain conferences
  • Jump on existing trains
  • Interview users and adapt
  • Find your audience & USPs
  • Find the right language
Develop the right thing, communicate it right

Communication is crucial


Communication barrier

  • Advertise channels to reach you
  • Be active on these channels

Notes:

  • Explain what you need and how to get it

Direct communication

  • Low barrier
  • Does not scale
  • Repeat for every similar case

Mailing list

  • Low barrier (?)
  • Reach inactive users
  • Fear of bothering
  • Non-searchable (?)
  • A thing of the past (?)

Chatroom

  • Low barrier
  • Some users stay
  • Chaotic
  • Non-searchable

Different kind of questions in chatroom: you need both!


Forum

  • Structured
  • Searchable
  • Also serves as FAQ
  • Some users stay
  • Higher barrier

Disclaimer: We only recently started with this


From user to contributor


Make it easy

  • Advertise where the development is done
    • Choose mainstream platforms
    • Don't require logging in to see the code
    • Don't "code available under request"
  • Document architecture
  • Setup CI / CD
  • Stick to standards
Welcome the tiniest contribution!

Notes:

  • Where do you need help?
  • Engage on GitHub

Split components

  • Easier to contribute to smaller codebase
  • Isolated potential damage
  • Might solve license issues

Notes:

  • Approaches: library, plug-ins
  • Each component can be a student project

preCICE ecosystem

Notes:

  • If you remember one thing

Give motives

  • Visibility
  • Shared ownership

Good community metrics?


Followers: interested in preCICE

scale max: 160 (cumulative)

Note: How do you measure your community?

vvv

Traffic: discovered preCICE

scale max: 500 (per two weeks)

vvv

Git clones: trying preCICE from source

scale max: 120 (per two weeks, bots included)

vvv

Binary package downloads

scale max: 400 (cumulative)


Community engagement

Repository Contrib. External
precice 24 5 (21%) 148 50
openfoam-adapter 6 2 (33%) 46 22
calculix-adapter 7 1 (14%) 7 23
mbdyn-adapter 3 2 (67%) 1 3

Too small numbers to conclude


Community engagement

Pull requests PR External Issues External
precice 259 10 (4%) 306 53 (17%)
openfoam-adapter 33 12 (36%) 67 18 (27%)
calculix-adapter 6 3 (50%) 15 5 (33%)
mbdyn-adapter 1 1 (100%) 0 0

Too small numbers to conclude

Notes:

  • Statistics obtained manually, but there is also a GitHub API
  • Is there any nice ready-to-use tool for this?

More metrics

  • Activity on channels
  • Citations
  • Activity on channels

vvv

Activity on channels

  • Gitter: 5 messages / day -- 14 active users / month
  • Discourse: 3 posts / day (just started)
  • Mailing list: 1 email / 2 days

vvv

Citations

Main preCICE paper (2016): 61 total citations

Notes:

  • Citation numbers lower than in other fields

vvv

Collaborations (which?)

  • Known users: 24 academic & 9 industrial groups
  • Testimonials: 11

Notes: Important to know (some of) your users!


Summary

Help the users help themselves!
preCICE website: www.precice.org - Twitter: @preCICE_org

Gerasimos Chourdakis (TUM)
Benjamin Uekermann (TU/e)
+ many more

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.
Get this presentation from GitHub.

Come to our poster (preCICE, sustainability, ...)