Skip to content

Commit 5fb10b8

Browse files
committed
Onboarding updates
1 parent cc196fc commit 5fb10b8

1 file changed

Lines changed: 54 additions & 75 deletions

File tree

onboarding.md

Lines changed: 54 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,45 @@
1-
# Onboarding
1+
# New team member onboarding
22

33
## Good to know
44

5-
CodeRefinery is a training network around FAIR research software development. We usually offer two massive streamed interactive online workshops per year with instructors from within the team but also try to onboard new instructors from anywhere. You can find all information about how we do workshops in our [manuals](https://coderefinery.github.io/manuals). Many partners are also collaborate on additional workshops or hackathons. But CodeRefinery is not only workshops: It also is a community of people who enjoy helping others. We also want to do more outreach, so if you are a social media guru or enjoy giving presentations in different forums, we would be delighted if you could help with that. Below you can find all links that are useful for anyone joining CodeRefinery in any capacity.
5+
CodeRefinery is a training network around FAIR research software development. We usually offer two massive streamed interactive online workshops per year with instructors from within the team but also try to onboard new instructors from anywhere. You can find all information about how we do workshops in our [manuals](https://coderefinery.github.io/manuals). Many partners are also collaborate on additional workshops or hackathons. But CodeRefinery is not only workshops: It also is a community of people who enjoy helping others. We also want to do more outreach, so if you are a social media guru or enjoy giving presentations in different forums, we would be delighted if you could help with that. Below you can find all links that are useful for anyone joining the CodeRefinery team.
6+
7+
Anyone can be part of the team! If your organization officially wants to join:
8+
- If your organization is in the Nordics, it can become a partner in the project.
9+
- If your organization is outside the Nordics, it can become an observer in the project.
10+
11+
Read about the [benefits for partner organizations](https://github.com/coderefinery/reports-and-proposals/blob/main/phase-4-proposal/info_for_new_organizations.md)
12+
613

714
## Links
815

916
### Connect
1017

1118
- Community chat - Zulip: [https://coderefinery.zulipchat.com](https://coderefinery.zulipchat.com)
1219
- in addition to default channels, join at least: #coderefinery and #tools-workshop
13-
- introduce yourself in #new-members
20+
- introduce yourself in #greetings>introductions
1421
- lots of optional channels, check them out!
1522
- CodeRefinery team meeting notes, agenda and connection details: [https://hackmd.io/@coderefinery/team-meeting](https://hackmd.io/@coderefinery/team-meeting)
1623
- Every Monday 14 CET in Zoom
1724
- Everybody welcome
25+
- CodeRefinery Ambassadors
26+
- Network of people that like what we do and want to help spread the word and give us feedback
27+
- Meets roughly every two months
28+
- [Mailing list](https://postit.csc.fi/sympa/subscribe/coderefinery-ambassadors/)
1829

1930
### Events
2031

2132
- Events calendar: [https://coderefinery.org/calendars/](https://coderefinery.org/calendars/)
2233
- Workshops: [https://coderefinery.org/workshops/](https://coderefinery.org/workshops/)
34+
- Events + workshop specific channels on Zulip chat
2335

2436
### News
2537

2638
- Mastodon: [https://fosstodon.org/@coderefinery](https://fosstodon.org/@coderefinery)
2739
- LinkedIn: [https://www.linkedin.com/company/coderefinery-research-software-development/](https://www.linkedin.com/company/coderefinery-research-software-development/)
2840
- BlueSky: [https://bsky.app/profile/coderefinery.org](https://bsky.app/profile/coderefinery.org)
2941
- Blog: [https://coderefinery.org/blog/](https://coderefinery.org/blog/)
42+
- Newsletters: [https://coderefinery.org/about/newsletter/](https://coderefinery.org/about/newsletter/)
3043

3144
### Collections
3245

@@ -39,9 +52,28 @@ CodeRefinery is a training network around FAIR research software development. We
3952
- Source and abstracts: [https://github.com/coderefinery/presentations](https://github.com/coderefinery/presentations)
4053
- Project reports and proposals [https://github.com/coderefinery/reports-and-proposals](https://github.com/coderefinery/reports-and-proposals)
4154

42-
## Become an instructor
55+
### Other links
56+
57+
- [CodeRefinery lesson template lesson](https://coderefinery.github.io/sphinx-lesson/)
58+
- Our website is on GitHub too, built with Zola -> [Website repository](https://github.com/coderefinery/coderefinery.org)
59+
- Registration management is done via [NeIC Indico](https://indico.neic.no)
60+
61+
## Accounts
62+
63+
- Zulip
64+
- GitHub
65+
- HackMD
66+
67+
## Team responsibilities
68+
69+
According to project plan: Engagement in project activities.
70+
It is up to you, which activities you would like to join. Individuals time is not tracked. But organizations are tracked, if original person month promise has been fulfilled.
71+
72+
## CodeRefinery activities you may want to join
4373

44-
We are always looking for new instructors for our main tools workshop happening twice a year in spring/autumn. For these workshops, we always have two instructors per topic and provide an instructor onboarding before the workshop when needed. We have gathered a lot of information and guides about "how to instructor at a CodeRefinery workshop", but the main aspects are summarized in our {doc}`instructor-intro`.
74+
### Instructor
75+
76+
Our main tools workshop is happening twice a year in spring/autumn. For these workshops, we always have two instructors per topic and provide an instructor onboarding before the workshop when needed. We have gathered a lot of information and guides about "how to instructor at a CodeRefinery workshop", but the main aspects are summarized in our {doc}`instructor-intro`.
4577

4678
As an instructor you should bring or be willing to acquire the following tools and skills:
4779

@@ -52,88 +84,35 @@ As an instructor you should bring or be willing to acquire the following tools a
5284
- Persons who like working with others since the teaching always happens in collaboration with others
5385
- A decent camera and microphone for clear audio and video
5486

87+
Apart from instructors, our workshops also have a lot of other roles to fill: {ref}`roles`.
5588

56-
## Help us improve our materials
89+
### Material contributor
5790

5891
Apart from lesson materials feedback and improvements, we also welcome any feedback and improvement suggestions on our manuals (these files here), installation instructions, webpage etc. Open tasks are summarized on the [CodeRefinery webpage](https://coderefinery.org/tasks/).
5992

93+
More info at {ref}`contribute`.
94+
95+
Help us make the lesson and other materials more clear, expand on examples, add exercises or new sections!
96+
6097
To help with material development, you will need or be ready to acquire the following tools and skills:
6198

6299
- GitHub account
63100
- Skills in open source collaborative lesson development; fits well as learning by doing!
64101

102+
Apart from contributing new materials, contributions by others also need to be reviewed.
103+
In order not to put pressure on the individuals we try to use the coderefinery-team as reviewers.
104+
If you notice a pending review, please at least read and comment, even if you do not feel confident in merging.
65105

66-
## As an organization
67-
68-
There is many ways your organization can join or support a workshop:
69-
70-
```{figure} img/participate_organization.png
71-
---
72-
align: center
73-
figwidth: 100%
74-
---
75-
76-
As a thank you we can add your organizations logo to the workshop page.
77-
78-
Please contact: support@coderefinery.org
79-
80-
## Find what you need
81-
82-
````{grid} 2
83-
:gutter: 1
84-
85-
```{grid-item-card} I want to support my local community join a CodeRefinery workshop!
86-
:class-card: sd-border-1 sd-animate-grow100
87-
88-
{octicon}`stopwatch;2em;sd-text-info` Minimal
89-
90-
Become a local classroom host or bring your own team to a workshop!
91-
92-
- {ref}`local-breakout-rooms`
93-
94-
Provide a more personal learning experience to your local community
95-
96-
```
97-
98-
```{grid-item-card} I would like to teach with CodeRefinery!
99-
:class-card: sd-border-5 sd-animate-grow100
100-
101-
{octicon}`stopwatch;2em;sd-text-info` During workshop times + preparation
102-
103-
Become an instructor!
104-
105-
- {ref}`instructor`
106-
107-
Help us make the live workshops a great educational experience for our learners!
108-
109-
```
110-
111-
```{grid-item-card} I would like to contribute to lesson materials!
112-
:class-card: sd-border-1 sd-animate-grow100
113-
114-
{octicon}`stopwatch;2em;sd-text-info` Whatever you got
115-
116-
Become a contributor!
117-
118-
- {ref}`contribute`
119-
120-
Help us make the lesson material more clear, expand on examples, add exercises or new sections!
121-
122-
```
123-
124-
```{grid-item-card} I would like to join everything you do!
125-
:class-card: sd-border-1 sd-animate-grow100
126-
127-
{octicon}`stopwatch;2em;sd-text-info` Minimum 10-20% of worktime
106+
### Organize other collaborative workshops
128107

129-
Become a member of the project!
108+
As mentioned above, CodeRefinery is a training collective. Apart from the main CodeRefinery workshop, partners may also choose to collaborate on other related training topics. The best way to get in touch is via Zulip chat.
130109

131-
If your organization is in the Nordics, you can become a partner in the project.
132-
If your organization is outside the Nordics, you can become an observer in the project.
110+
### Support with outreach
133111

134-
- Read about the [benefits for partner organizations](https://github.com/coderefinery/reports-and-proposals/blob/main/phase-4-proposal/info_for_new_organizations.md)
112+
It is incredibly hard to reach our target audience at the right time in their career. Please help!
113+
We have social media channels that could always use some entertaining posts, a blog to share experiences, submit a talk or poster for a domain specific conference, or other places where our target audience may already be.
135114

136-
```
137-
````
115+
## Thank you!
138116

139-
If none of above fit your profile or time, you can also support the project by helping us to spread the word, give us feedback and get in touch with others doing similar things! -> Become a CodeRefinery ambassador ({ref}`ambassador`)!
117+
No matter what you choose to do, we are happy to have you!
118+
CodeRefinery lives through its people and community!

0 commit comments

Comments
 (0)