Skip to content

Commit 9d7af45

Browse files
Merge pull request #24 from ropenscilabs/steffi-edits
2 parents 2069861 + 75737b5 commit 9d7af45

File tree

12 files changed

+215
-125
lines changed

12 files changed

+215
-125
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,3 +4,4 @@
44
.Ruserdata
55

66
/.quarto/
7+
_book/

.vscode/settings.json

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
{
2+
"cSpell.words": [
3+
"Airtable",
4+
"Aurélio",
5+
"commcall",
6+
"comunidade",
7+
"cowork",
8+
"coworking",
9+
"CSCW",
10+
"documentclass",
11+
"Eventbrite",
12+
"fala",
13+
"FOSS",
14+
"Gerosa",
15+
"hackathon",
16+
"hackathons",
17+
"panelists",
18+
"português",
19+
"Redmiles",
20+
"Rproj",
21+
"Ruserdata",
22+
"Saibene",
23+
"scrreprt",
24+
"Steinmacher",
25+
"Tayana",
26+
"Tradução",
27+
"translathon",
28+
"translathons"
29+
]
30+
}

_quarto.yml

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,13 @@ project:
22
type: book
33

44
book:
5-
title: "FTCFOSS-Guide"
6-
author: "Yani and Steffi"
7-
date: "4/27/2025"
5+
title: "From User to Contributor: Organizing Events for First-Time Contributors"
6+
author: "Yanina Bellini Saibene and Steffi LaZerte"
7+
date: "10/10/2025"
88
favicon: apple-touch-icon.png
99
repo-url: https://github.com/ropenscilabs/FTCFOSS-Guide
1010
chapters:
1111
- index.qmd
12-
- intro.qmd
1312
- pilot.qmd
1413
- event-overview.qmd
1514
- commcall.qmd

commcall.qmd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ We create a event page in our website under Community Calls to share the main in
2727

2828
The event page is shared through our communications channels:
2929

30-
* **Newsletter:** Our newsletter has around 2500 registered readers. We shared all upcoming community calls in our HQ section and the resources (like video, articles and slides) after the call.
30+
* **Newsletter:** Our newsletter reaches a large audience (>1000 opens per month). We shared all upcoming community calls in our HQ section and the resources (like video, articles and slides) after the call.
3131

3232
* **Social Media:** Before the call, we use social media posts to announce the theme and raise awareness. We set the same agenda for all community calls: a "Save the date" announcement a month before, a reminder one week before the event, one day before the event and one hour before the call.
3333
During the community call, we live-post under a dedicated hashtag (#translathon and #rohackathon2025), sharing screenshots, participant quotes, and quick updates to capture the energy of the event. After the call, we post highlights and linked to the [recap blog](/blog/2025/01/24/coworking-hackathons/), while beginning a countdown to the hackathon.

event-overview.qmd

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Events Overview
1+
# Events Overview {#overview}
22

33
Here we have a rough overview of the projected timeline for running a set of events.
44
One set of events consists of a Community Call paired with 1-2 hands-on mini-hackathons or mini-translathons.
@@ -8,24 +8,22 @@ See the relevant chapter for specific details for organizing a specific event ty
88

99
## Timeline
1010

11-
Chp | Task | Platform
11+
Chapter | Task | Platform
1212
--- | ---------------------------------------- | -------------
13-
[2](#community-call) | Contact potential panelists and moderators for Community Call | Email etc.
14-
[2](#community-call) | Choose date for Community call with participants' input |
15-
[2](#community-call) | Advertise Community call | Website / Social Media
16-
[5](#mini-translathon)/[6](#mini-hackathon) | Choose date(s) for mini-translathon/hackathon |
17-
[5](#mini-translathon)/[6](#mini-hackathon) | Open call for mentors/maintainers at hands-on events | Blog / Registration
18-
[5](#mini-translathon)/[6](#mini-hackathon) | Advertise Mini-translathon(s)/hackathon(s) | Website / Social Media
19-
[5](#mini-translathon)/[6](#mini-hackathon) | Open call for participants at hands-on event(s) | Blog / Registration
20-
[2](#community-call) | Run Community Call | Zoom / Docs
21-
[5](#mini-translathon)/[6](#mini-hackathon) | Run mini-translathon(s)/hackathon(s) | Zoom / Docs
22-
[5](#mini-translathon)/[6](#mini-hackathon) | Evaluate participant [feedback](pilot.html#feedback) |
23-
24-
<!-- TODO: Yani, does this timeline work for the translathons as well as the hackathons? -->
25-
26-
## Summary Comparision
27-
28-
| **Aspect** | **Mini-Hackathon** | **Traslathon** |
13+
[4](commcall.qmd) | Contact potential panelists and moderators for Community Call | Email etc.
14+
[4](commcall.qmd) | Choose date for Community call with participants' input |
15+
[4](commcall.qmd) | Advertise Community call | Website / Social Media
16+
[5](translathon.qmd)/[6](hackathon.qmd) | Choose date(s) for mini-translathon/hackathon |
17+
[5](translathon.qmd)/[6](hackathon.qmd) | Open call for mentors/maintainers at hands-on events | Blog / Registration
18+
[5](translathon.qmd)/[6](hackathon.qmd) | Advertise Mini-translathon(s)/hackathon(s) | Website / Social Media
19+
[5](translathon.qmd)/[6](hackathon.qmd) | Open call for participants at hands-on event(s) | Blog / Registration
20+
[4](commcall.qmd) | Run Community Call | Zoom / Docs
21+
[5](translathon.qmd)/[6](hackathon.qmd) | Run mini-translathon(s)/hackathon(s) | Zoom / Docs
22+
[5](translathon.qmd)/[6](hackathon.qmd) | Evaluate participant [feedback](pilot.qmd#feedback) |
23+
24+
## Summary Comparison
25+
26+
| **Aspect** | **Mini-Hackathon** | **Translathon** |
2927
|------------------------|------------------------|------------------------|
3028
| **Main Goal** | Help participants make their **first contributions** to FOSS projects, usually through coding or documentation. | Help participants make their **first contributions** to translations/localizations of FOSS documentation or websites. |
3129
| **Format** | 2-hour live online coworking session combining hackathon + rOpenSci coworking. | 2-hour live online coworking session combining translation + rOpenSci coworking. |

examples_socials.qmd

Lines changed: 67 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,4 +89,70 @@ Original posted on [Mastodon](https://hachyderm.io/@rOpenSci/114104077511757525)
8989
> https://ropensci.org/events/coworking-2025-03
9090
>
9191
> #RStats
92-
92+
93+
94+
---
95+
96+
## Traslathon
97+
98+
### Before the event
99+
100+
Original posted on [Mastodon](https://hachyderm.io/@rOpenSci/113385128160490468)
101+
102+
> Essa chamada da comunidade será seguida por uma reunião de tradução na @latinr_conf
103+
>
104+
> 🕓 Monday, 18 November 2024 - 13:00 UTC.
105+
> https://www.eventbrite.cl/e/traducao-hackathon-traslaton-ropensci-tickets-1045507530167
106+
107+
108+
---
109+
110+
Original posted on [Mastodon](https://fosstodon.org/@yabellini/113503640649820012)
111+
112+
> Es hoy! Es hoy!!!
113+
>
114+
> Arranca @latinr_conf
115+
>
116+
> Venite al Traslaton de @rOpenSci a las 10:00 am UTC-3
117+
>
118+
> https://www.eventbrite.cl/e/traducao-hackathon-traslaton-ropensci-tickets-1045507530167
119+
120+
---
121+
122+
### During the event
123+
124+
Live posting of the activities happening during the event. Original posted on [Mastodon](https://fosstodon.org/@yabellini/113504172589903267)
125+
126+
> Our @rOpenSci Traslaton started !!
127+
>
128+
> @pedropark99 is explaining our review process
129+
130+
> @rOpenSci @pedropark99
131+
>
132+
> Now @beamilz is doing the first review of the PR with the authomatic translation of our CoC in Portuguese:
133+
>
134+
> https://github.com/ropensci/roweb3/pull/890
135+
> ...
136+
>
137+
138+
---
139+
140+
### At the end of the event
141+
142+
Original posted on [Mastodon](https://fosstodon.org/@yabellini/113504968115673613)
143+
144+
@rOpenSci @latinr_conf
145+
146+
> Traslatón summary:
147+
>
148+
> - 4 merged PR by @pedropark99 + Rafael Fontenelle + Ildeberto Vasconcelos
149+
>
150+
> - CoC Automatic translation finished + First Review finished + Second Review started by @beamilz and Francesca Palmeira
151+
>
152+
> - 2 first review started by Bea Milz and Rafael Fontenelle
153+
>
154+
> - 1 second review started by Ariana Cabral and 1 finished by Samuel Carleial
155+
>
156+
> We discuss a Portuguese glossary and the overall process.
157+
>
158+
> Thank so much to all the participants 🙏 🤩 🚀

hackathon.qmd

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
1-
---
2-
title: "Mini-hackathons"
3-
---
1+
# Mini-hackathons {#hackathon}
42

5-
## Overview
3+
## Overview
64

75
Mini-hackathons are 2-hr events designed as a variation on the standard rOpenSci coworking format.
86
They are a combination of a hackathon (a dedicated period of time where participants make contributions to selected FOSS projects)
@@ -195,7 +193,6 @@ and [Coworking Document](https://docs.google.com/document/d/1juXuCMvz7a9BX_VK6SO
195193
- Share contributions on social media (use the event hastag) and in the event Slack channel
196194
- Remind people to fill out the feedback form throughout the event
197195

198-
199196
#### After {-}
200197
- Follow up as needed on Slack, keep updating PR merges etc.
201198
- Send out email to maintainers and mentors to thank them and give them details on how to receive honourarium

index.qmd

Lines changed: 41 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,53 @@ toc: false
66
# Preface
77
:::
88

9-
## **Community-Driven Open Source:<br>Enabling First-Time Contributors to Open Source Projects** {-}
9+
Over the last decade, [rOpenSci](https://ropensci.org) has played a pivotal role in diversifying the open research software community by integrating new developers from underrepresented communities and enabling newcomers to become regular contributors to our federation of scientific software via various engagement channels.
10+
In 2024 we piloted a new program to support first-time contributors to open source projects.
1011

11-
Over the last decade, [rOpenSci](https://ropensci.org) has played a pivotal role in diversifying the open research software community by integrating new developers from underrepresented communities and transforming newcomers into regular contributors to our federation of scientific software via various engagement channels.
12+
**Making your first contribution to open source can be both empowering and yet very intimidating.**
1213

13-
To further this work, in 2024 we proposed to pilot a new program designed to support sustainability for scientific software packages by recruiting and mentoring contributors and co-maintainers, using community calls and coworking sessions (mini-hackathons and mini-translathons) to provide a structured yet flexible environment to onboard new participants to open-source projects in real-time.
14+
Steinmacher et al.[^1] identified 13 social barriers preventing newcomers from making their first contributions to open source software projects, including barriers related to Reception, Communication, and Orientation. We consider that most of these barriers are, in one way or another, related to:
15+
16+
1. How easy it is to get set up to make a contribution
17+
18+
2. How easy it is to find a task to start with
19+
20+
3. How warmly first contribution is received
21+
22+
Therefore, to encourage and empower contributors, we created a new type of community event which supports specifically first-time contributors to open source software and translation projects.
23+
Our goal was to create an inclusive and supportive environment, which would result in a positive learning experience and empower participants to continue contributing.
24+
25+
We designed and piloted this new community event format based on pairing
26+
[community calls](https://ropensci.org/commcalls) to introduce the topics,
27+
and specialized hands-on [coworking](https://ropensci.org/coworking) sessions (mini-translathons and mini-hackathons) to give opportunities for participation.
28+
29+
rOpenSci **Community Calls** are 1-hour online events with 2-5 speakers, 1 moderator, and include 20-40 minutes of discussion/Q&A.
30+
These calls serve to strengthen connections between members of the rOpenSci community, teach technical and social topics, bring different stakeholders’ perspectives to light, and identify unmet needs on a topic.
31+
Video, transcripts, notes and summaries of all our calls are published.
32+
We have hosted over 40 calls over the last 10 years and attract a global audience with representation from academia, government, non-profit, and industry.
33+
We have also started holding these events in Spanish (as of 2023) and Portuguese (as of 2024) to expand global accessibility.
34+
35+
**Coworking** sessions are informal, online, gatherings held once a month in rotating timezones.
36+
Each session features a different theme and Community Host with expertise in that theme, facilitated by rOpenSci staff. 
37+
At these events, participants meet other scientific software developers and experts, cowork on their own projects, and/or ask questions and receive guidance as they work.
38+
After each session we publish shared notes and resources.
39+
We have hosted over 40 sessions since 2021.
40+
41+
This book presents the experiences and lessons learned through our [pilot events](pilot.html),
42+
an [overview](event-overview.html) of how to run these kinds of events,
43+
and specific details on how to run the [community calls](commcall.html),
44+
[mini-translathons](translathon.html), and [mini-hackathons](hackathon.html).
45+
In the Appendices we share examples and templates useful for running these events.
1446

15-
This book presents the lessons learned and the organization details of these events.
1647
While instructions and notes are presented within an rOpenSci context, we hope that they are clear enough
1748
that they could be adapted as a model for use in other organizations.
18-
The format has been designed to be scalable across our federation of scientific open source software and we hope will serve as a model for maintainers to replicate in recruiting contributors and co-maintainers.
49+
The format has been designed to be scalable across our federation of scientific open source software and serves as a model for maintainers to replicate in recruiting contributors and co-maintainers.
50+
51+
We hope this book will inspire and empower you to run your own events to support first-time contributors to open source software and translation projects.
52+
53+
[^1]: Igor Steinmacher, Tayana Conte, Marco Aurélio Gerosa, and David Redmiles. 2015. Social Barriers Faced by Newcomers Placing Their First Contribution in Open Source Software Projects. In Proceedings of the 18th ACM Conference on Computer Supported Cooperative Work &amp; Social Computing (CSCW '15). Association for Computing Machinery, New York, NY, USA, 1379–1392. <https://doi.org/10.1145/2675133.2675215>
1954

55+
### Contributions to this book
2056
If you find any errors or things that need clarification, we would be grateful if you opened an issue or pull request in the repository for this book.
2157

2258
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 United States License.

intro.qmd

Lines changed: 0 additions & 41 deletions
This file was deleted.

0 commit comments

Comments
 (0)