Skip to content

Commit

Permalink
Merge pull request #273 from carpentries/issue-233
Browse files Browse the repository at this point in the history
Added an exercise/top tips for collaboration
  • Loading branch information
sstevens2 authored Sep 20, 2023
2 parents 5001c46 + 35e6912 commit ebf6d61
Showing 1 changed file with 46 additions and 1 deletion.
47 changes: 46 additions & 1 deletion episodes/wrap-up3.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,55 @@ After completing this episode, participants should be able to...

::::::::::::::::::::::::::::::::::::::::::::::::::

We have reached the end of this training.

## Looking Back

Throughout this training we promoted a collaborative approach to lesson development (as many other initiatives in The Carpentries community are conducted). Collaboration helps bring different skills and perspectives to a project and share the load of the work required to bring the project successfully past the finishing line. For lesson projects, this shared effort also extends to maintaining and updating the lesson after the initial development phase.

::::::::::::: discussion

## Exercise: What steps can you take to be a good collaborator? (20 minutes)

Spend some time reflecting on collaboration aspects we covered in this training and exploring at least two of the
following lesson repositories, noting down what things you noticed in these repositories that could aid collaboration:

- [Collaborative Lesson Development Training](https://github.com/carpentries/lesson-development-training) (this lesson)
- [Introduction to Working with Data (Regular Expressions)](https://github.com/librarycarpentry/lc-data-intro/) official Library Carpentry lesson
- [Introduction to Geospatial Raster and Vector Data with Python](https://github.com/carpentries-incubator/geospatial-python) lesson in Carpentries Incubator
- [Introduction to R for Metagenomics](https://github.com/carpentries-lab/metagenomics-R) lesson in Carpentries Lab

Trainers will then lead a discussion on what people found and steps you could take to improve your lesson repository.

:::::::::::::

### Collaboration Top Tips

While you will know the best collaboration practices for your team, here are some suggestions:

1. Provide ‘external-facing’ features for your lesson (such as description, objectives, contribution and 'how to get involved'
guides, preferred way of communication) - these will be universally useful for everyone coming to your repository (your team included).
2. Find the best tools that work for your team for communication, documentation and knowledge sharing, issue & project management.
3. Document and share knowledge within the team to facilitate team collaboration. Share decisions and communicate with your team synchronously and asynchronously.
4. Plan your meetings to get the most out of your team (e.g. set agenda, assign meeting roles - chair, note-taker, time-keeper, etc.)
and be appreciative of people's times.
5. Record and manage issues with your lesson as you develop, trial and maintain it (e.g. assign people responsible for
issues, categorise and prioritise them).
6. Assign tasks and roles to distribute the responsibilities - this includes assigning larger roles (project management
& governance) to team members and assigning specific issues/tasks to collaborators. Progress is much more likely to be made
when people know what they and others should be working on.
7. Dedicated sprints where the whole team works on a set of issues towards a milestone work well for lesson development and making progress on projects in general.
8. Be open and welcoming to new contributors and provide different opportunities to get involved with your project
(from novice to expert collaborators). Point to upskilling guides (or run upskilling sessions if possible) to bring people
up to speed.
9. Manage contributions in a timely manner by noticing when things happen and responding to new issues, comments and
Pull Requests (PRs). Show appreciation for everyone's contributions.
10. People bring different perspectives, expertise and skills to a collaborative project and, while they can be productive
and harmoniously complement each other, having some decision making and conflict resolution process in place will make sure
progress can be made when disagreements arise.

## Looking Ahead

We have reached the end of this training.
By now, you should have made good progress towards a first draft of your lesson.

Referring back to [the life cycle stages for lessons](operations.md)
Expand Down

0 comments on commit ebf6d61

Please sign in to comment.