Skip to content

Move Pilot and flesh out Feedback #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# Guide for First-time Contributor to FOSS events at rOpenSci

## TODO
- Replace all `XX`'s with values
- Fix all `TODO`s
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.

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.

This book presents the lessons learned and the organization details of these events.
While instructions and notes are presented within an rOpenSci context, we hope that they are clear enough
that they could be adapted as a model for use in other organizations.
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.

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.

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

This work was supported by a NumFOCUS Small Development Grant to rOpenSci.
70 changes: 41 additions & 29 deletions _book/commcall.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">


<title>4&nbsp; Community Call – FTCFOSS-Guide</title>
<title>5&nbsp; Community Calls – FTCFOSS-Guide</title>
<style>
code{white-space: pre-wrap;}
span.smallcaps{font-variant: small-caps;}
Expand Down Expand Up @@ -82,7 +82,7 @@
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
<i class="bi bi-layout-text-sidebar-reverse"></i>
</button>
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="./commcall.html"><span class="chapter-number">4</span>&nbsp; <span class="chapter-title">Community Call</span></a></li></ol></nav>
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="./commcall.html"><span class="chapter-number">5</span>&nbsp; <span class="chapter-title">Community Calls</span></a></li></ol></nav>
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
</a>
<button type="button" class="btn quarto-search-button" aria-label="Search" onclick="window.quartoOpenSearch();">
Expand Down Expand Up @@ -121,29 +121,35 @@
<a href="./intro.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">2</span>&nbsp; <span class="chapter-title">Introduction</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./pilot.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Pilot</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./event-overview.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Events Overview</span></span></a>
<span class="menu-text"><span class="chapter-number">4</span>&nbsp; <span class="chapter-title">Events Overview</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./commcall.html" class="sidebar-item-text sidebar-link active">
<span class="menu-text"><span class="chapter-number">4</span>&nbsp; <span class="chapter-title">Community Call</span></span></a>
<span class="menu-text"><span class="chapter-number">5</span>&nbsp; <span class="chapter-title">Community Calls</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./translathon.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">5</span>&nbsp; <span class="chapter-title">Mini-translathon</span></span></a>
<span class="menu-text"><span class="chapter-number">6</span>&nbsp; <span class="chapter-title">Mini-translathon</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./hackathon.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">6</span>&nbsp; <span class="chapter-title">Mini-hackathon</span></span></a>
<span class="menu-text"><span class="chapter-number">7</span>&nbsp; <span class="chapter-title">Mini-hackathons</span></span></a>
</div>
</li>
<li class="sidebar-item sidebar-item-section">
Expand All @@ -158,7 +164,7 @@
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./resources.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">A</span>&nbsp; <span class="chapter-title">Resources</span></span></a>
<span class="menu-text"><span class="chapter-number">A</span>&nbsp; <span class="chapter-title">Example Resources</span></span></a>
</div>
</li>
<li class="sidebar-item">
Expand All @@ -172,6 +178,12 @@
<a href="./templates_forms.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">C</span>&nbsp; <span class="chapter-title">Form templates</span></span></a>
</div>
</li>
<li class="sidebar-item">
<div class="sidebar-item-container">
<a href="./examples_socials.html" class="sidebar-item-text sidebar-link">
<span class="menu-text"><span class="chapter-number">D</span>&nbsp; <span class="chapter-title">Social Media examples</span></span></a>
</div>
</li>
</ul>
</li>
Expand All @@ -185,13 +197,13 @@
<h2 id="toc-title">Table of contents</h2>

<ul>
<li><a href="#communication" id="toc-communication" class="nav-link active" data-scroll-target="#communication"><span class="header-section-number">4.1</span> Communication</a>
<li><a href="#communication" id="toc-communication" class="nav-link active" data-scroll-target="#communication"><span class="header-section-number">5.1</span> Communication</a>
<ul class="collapse">
<li><a href="#blog-post" id="toc-blog-post" class="nav-link" data-scroll-target="#blog-post"><span class="header-section-number">4.1.1</span> Blog post</a></li>
<li><a href="#newsletter" id="toc-newsletter" class="nav-link" data-scroll-target="#newsletter"><span class="header-section-number">4.1.2</span> Newsletter</a></li>
<li><a href="#slack" id="toc-slack" class="nav-link" data-scroll-target="#slack"><span class="header-section-number">4.1.3</span> Slack</a></li>
<li><a href="#email" id="toc-email" class="nav-link" data-scroll-target="#email"><span class="header-section-number">4.1.4</span> Email</a></li>
<li><a href="#social-media" id="toc-social-media" class="nav-link" data-scroll-target="#social-media"><span class="header-section-number">4.1.5</span> Social Media</a></li>
<li><a href="#blog-post" id="toc-blog-post" class="nav-link" data-scroll-target="#blog-post"><span class="header-section-number">5.1.1</span> Blog post</a></li>
<li><a href="#newsletter" id="toc-newsletter" class="nav-link" data-scroll-target="#newsletter"><span class="header-section-number">5.1.2</span> Newsletter</a></li>
<li><a href="#slack" id="toc-slack" class="nav-link" data-scroll-target="#slack"><span class="header-section-number">5.1.3</span> Slack</a></li>
<li><a href="#email" id="toc-email" class="nav-link" data-scroll-target="#email"><span class="header-section-number">5.1.4</span> Email</a></li>
<li><a href="#social-media" id="toc-social-media" class="nav-link" data-scroll-target="#social-media"><span class="header-section-number">5.1.5</span> Social Media</a></li>
</ul></li>
</ul>
</nav>
Expand All @@ -201,7 +213,7 @@ <h2 id="toc-title">Table of contents</h2>

<header id="title-block-header" class="quarto-title-block default">
<div class="quarto-title">
<h1 class="title"><span class="chapter-number">4</span>&nbsp; <span class="chapter-title">Community Call</span></h1>
<h1 class="title"><span class="chapter-number">5</span>&nbsp; <span class="chapter-title">Community Calls</span></h1>
</div>


Expand All @@ -221,31 +233,31 @@ <h1 class="title"><span class="chapter-number">4</span>&nbsp; <span class="chapt
<p>rOpenSci <a href="https://ropensci.org/commcalls">Community Calls</a> are Zoom calls held several times a year featuring a panel of speakers on a specific topic with a significant Question &amp; Answer period. Calls cover a variety of topics, from technical (<a href="https://ropensci.org/commcalls/jun2023-arrow/">“A Journey through Arrow in R”</a>) to community (<a href="https://ropensci.org/commcalls/apr2021-pkg-community/">“Set Up Your Package to Foster a Community”</a>). Most topics are in English, but we are introducing Calls in Spanish (<a href="https://ropensci.org/es/commcalls/nov2023-multilenguaje/">“Proyecto Multilingüe”</a>) as well as in Portugese(<a href="https://ropensci.org/commcalls/translation-portuguese/">“A comunidade R fala português”</a>, part of this Pilot)].</p>
<p>For general organizing, see our blog post <a href="https://ropensci.org/blog/2021/02/02/ropensci-community-calls/">“How rOpenSci Runs Community Calls”</a> as well as our <a href="https://github.com/ropensci-org/community-calls/blob/master/checklist.md">“Checklist for a Community Call”</a>.</p>
<p>In this chapter we will address the specifics of running a Community Call to support first time contributors to open source software.</p>
<!-- Yani, I would suggest only adding things here which are specific to this
<!-- TODO: Yani, I would suggest only adding things here which are specific to this
project. Anything that is a general Community Call organization thing and which
is covered in the above links I think you can either omit, or simply refer to the
above links. No need to 'reinvent the wheel' ;) -->
<section id="communication" class="level2" data-number="4.1">
<h2 data-number="4.1" class="anchored" data-anchor-id="communication"><span class="header-section-number">4.1</span> Communication</h2>
<section id="blog-post" class="level3" data-number="4.1.1">
<h3 data-number="4.1.1" class="anchored" data-anchor-id="blog-post"><span class="header-section-number">4.1.1</span> Blog post</h3>
<section id="communication" class="level2" data-number="5.1">
<h2 data-number="5.1" class="anchored" data-anchor-id="communication"><span class="header-section-number">5.1</span> Communication</h2>
<section id="blog-post" class="level3" data-number="5.1.1">
<h3 data-number="5.1.1" class="anchored" data-anchor-id="blog-post"><span class="header-section-number">5.1.1</span> Blog post</h3>
</section>
<section id="newsletter" class="level3" data-number="4.1.2">
<h3 data-number="4.1.2" class="anchored" data-anchor-id="newsletter"><span class="header-section-number">4.1.2</span> Newsletter</h3>
<section id="newsletter" class="level3" data-number="5.1.2">
<h3 data-number="5.1.2" class="anchored" data-anchor-id="newsletter"><span class="header-section-number">5.1.2</span> Newsletter</h3>
</section>
<section id="slack" class="level3" data-number="4.1.3">
<h3 data-number="4.1.3" class="anchored" data-anchor-id="slack"><span class="header-section-number">4.1.3</span> Slack</h3>
<section id="slack" class="level3" data-number="5.1.3">
<h3 data-number="5.1.3" class="anchored" data-anchor-id="slack"><span class="header-section-number">5.1.3</span> Slack</h3>
<p>Gather stories about first time contributions from the Slack</p>
<ol type="1">
<li>“Do you remember your first time contribution…?”</li>
<li>“Do you remember the first time you helped someone contribute…?”</li>
</ol>
</section>
<section id="email" class="level3" data-number="4.1.4">
<h3 data-number="4.1.4" class="anchored" data-anchor-id="email"><span class="header-section-number">4.1.4</span> Email</h3>
<section id="email" class="level3" data-number="5.1.4">
<h3 data-number="5.1.4" class="anchored" data-anchor-id="email"><span class="header-section-number">5.1.4</span> Email</h3>
</section>
<section id="social-media" class="level3" data-number="4.1.5">
<h3 data-number="4.1.5" class="anchored" data-anchor-id="social-media"><span class="header-section-number">4.1.5</span> Social Media</h3>
<section id="social-media" class="level3" data-number="5.1.5">
<h3 data-number="5.1.5" class="anchored" data-anchor-id="social-media"><span class="header-section-number">5.1.5</span> Social Media</h3>
<p>Hastag Live posting</p>


Expand Down Expand Up @@ -673,12 +685,12 @@ <h3 data-number="4.1.5" class="anchored" data-anchor-id="social-media"><span cla
<nav class="page-navigation">
<div class="nav-page nav-page-previous">
<a href="./event-overview.html" class="pagination-link" aria-label="Events Overview">
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">3</span>&nbsp; <span class="chapter-title">Events Overview</span></span>
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">4</span>&nbsp; <span class="chapter-title">Events Overview</span></span>
</a>
</div>
<div class="nav-page nav-page-next">
<a href="./translathon.html" class="pagination-link" aria-label="Mini-translathon">
<span class="nav-page-text"><span class="chapter-number">5</span>&nbsp; <span class="chapter-title">Mini-translathon</span></span> <i class="bi bi-arrow-right-short"></i>
<span class="nav-page-text"><span class="chapter-number">6</span>&nbsp; <span class="chapter-title">Mini-translathon</span></span> <i class="bi bi-arrow-right-short"></i>
</a>
</div>
</nav>
Expand Down
Loading