Skip to content

Commit d262771

Browse files
authored
Add retro notes from new contributors ensemble (#1765)
* Add retro folder and notes from last Friday * Add retro doc from the previous new-contributors session * Add some more actions from previous retro * Add pointer to retro-tools * Use youtube link for stream which is permanent * Move retro stuff into docs folder * Fix link to issue
1 parent 04ef57d commit d262771

File tree

3 files changed

+97
-0
lines changed

3 files changed

+97
-0
lines changed

docs/retro/2021/07/17.md

+46
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# 2021-07-17
2+
3+
This retrospective was from the first [new contributors mob/ensemble]. Sadly [@mattwynne] failed to record the stream, so there's no video from this session.
4+
5+
## Who
6+
7+
* [@artismarti]
8+
* [@16sheep]
9+
* [@eoola]
10+
* [@mattwynne] (taking these notes)
11+
12+
## What happened?
13+
14+
* We read the issues at https://github.com/cucumber/cucumber-js/contribute
15+
* We decided to tackle one
16+
* We discussed how contributing to the repo worked
17+
* We changed what to tackle and tackled something simpler
18+
* We made a [PR](https://github.com/cucumber/cucumber-js/pull/1734).
19+
20+
## What worked? What do you appreciate?
21+
22+
* I learned general concepts that I could use in other open source projects
23+
* The issues were good for first timers. I'm keen to explore more now I've looked through them!
24+
* It was so much fun! All the intimidation I had about starting to do this vanished. Low stakes way of learning new things. A nice way of learning new stuff!
25+
* The team gelled almost instantly
26+
27+
## What was puzzling or frustrating?
28+
29+
* Why did the tests pass on your device but not mine?
30+
* Live Share vs Screen Share it was a bit confusing
31+
* Would it be easier to just run it locally on one of our machines? More realistic.
32+
* Twitch setup (Matt heard his own voice the whole way through, and we started late)
33+
34+
## What should we decide / change for next time?
35+
36+
* Do this regularly but on any codebase, not just Cucumber
37+
* Would it be easier to just run it locally on one of our machines?
38+
* Matt do more homeowrk on twitch setup
39+
* Let's do this again!
40+
* Update CONTRIBUTING.md guide to include pointers to basics about forking, how to name your branch etc., and some words of comfort and encouragement to make mistakes, ask for help etc.
41+
42+
[@artismarti]: https://github.com/artismarti
43+
[@mattwynne]: https://github.com/mattwynne
44+
[@16sheep]: https://github.com/16sheep
45+
[@eoola]: https://github.com/eoola
46+
[new contributors mob/ensemble]: https://cucumber.io/blog/open-source/tackling-structural-racism-(and-sexism)-in-open-so/

docs/retro/2021/08/06.md

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# 2021-08-06
2+
3+
This session was streamed live and recorded. Watch the video [here](https://youtu.be/EiqLzBBpjxM).
4+
5+
## Who
6+
7+
* [@artismarti]
8+
* [@16sheep]
9+
* [@mattwynne] (taking these notes)
10+
11+
## What happened
12+
13+
* Discussed what to do.
14+
* Worked from Marju's fork, using our own local machines and VSCode each time we switched driver.
15+
* Re-did the work we did last time on the mobbing machine, using Marju's machine to submit a new PR ([#1764]) cleanly. We learned about `git cherry-pick`.
16+
* Started working through the pre-prepared issue [#1136] in a [branch on Marju's fork](https://github.com/16sheep/cucumber-js/tree/opt-out-print-attachments-1136)
17+
* Arti had to leave a bit early
18+
19+
## Insights
20+
21+
* Preferred working on own machine, not using the live share / mobbing machine.
22+
* Good to prepare. But, wonder if you over-prepare, it doesn't leave space for people to explore and learn.
23+
* Good to have an issue to focus on, and perhaps a failing test (but we could also write this ourselves).
24+
* It would help to share what we're goin g to work on beforehand so people watching can also know ahead of time. Decide now for next session?
25+
* Matt didn't like being in charge of the timer.
26+
* Could use different mechanism for changing turns, like when we make a commit, or when a test is passing?
27+
* More people would be nice. Should we make it easier for people to join? How? How often can we run it?
28+
29+
### Actions / decisions
30+
31+
* Next time, continue with fixing [#1136]
32+
33+
[@artismarti]: https://github.com/artismarti
34+
[@mattwynne]: https://github.com/mattwynne
35+
[@16sheep]: https://github.com/16sheep
36+
[#1764]: https://github.com/cucumber/cucumber-js/pull/1764
37+
[#1136]: https://github.com/cucumber/cucumber-js/issues/1136
38+

docs/retro/README.md

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Retrospective notes
2+
3+
From time to time, we run a mobbing/ensemble session on this codebase. At the end of each session., we
4+
run a brief [retrospective] conversation in an effort to "turn up the good" – Woody Zuill.
5+
6+
Each retro we run is recorded in this folder as a dated Markdown file.
7+
8+
e.g. To find the retrospective for 23rd May 2020 you would look in the file `2020/05/23.md`
9+
10+
We use [retro-tools] to help manage these files.
11+
12+
[retrospective]: https://www.agilealliance.org/glossary/heartbeatretro/
13+
[retro-tools]: https://github.com/tooky/retro-tools

0 commit comments

Comments
 (0)