Skip to content

Commit 1baeda2

Browse files
lwjohnst86signekbpre-commit-ci[bot]
authored
feat: ✨ guide on start of iteration (#32)
# Description Section on doing the start of an iteration. This PR needs a quick review. ## Checklist - [x] Formatted Markdown - [x] Ran `just run-all` --------- Co-authored-by: Signe Kirk Brødbæk <[email protected]> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
1 parent b7d79e8 commit 1baeda2

File tree

3 files changed

+80
-0
lines changed

3 files changed

+80
-0
lines changed

_quarto.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,9 @@ book:
2222
:::
2323
chapters:
2424
- index.qmd
25+
- part: "Iterations"
26+
chapters:
27+
- iterations/start.qmd
2528
- part: "Operations"
2629
chapters:
2730
- operations/security.qmd

iterations/_preamble.qmd

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
::: callout-important
2+
We track our iterations' progress and tasks on GitHub with [this project
3+
board](https://github.com/orgs/seedcase-project/projects/18/).
4+
:::
5+
6+
::: callout-tip
7+
- It's good practice to assign a timekeeper to keep us on track and so
8+
we avoid spending too long on any one topic.
9+
- While this guide can apply to all members of the team, several parts
10+
of it are specific to the team lead. Those parts will be explicitly
11+
marked to indicate that they are only for the team lead.
12+
:::

iterations/start.qmd

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Start of an iteration
2+
3+
{{< include _preamble.qmd >}}
4+
5+
An iteration starts with a planning meeting at the start of each month.
6+
It should ideally be between 30-45 minutes. If you are the team lead,
7+
you should already have prepared for and made a general plan for the
8+
iteration, so this meeting should not be used as a way for everyone to
9+
write out and list all the tasks needed. Rather, the main purpose of
10+
this meeting is to get everyone aligned on the aim(s) and overall plan.
11+
12+
This meeting should ideally *not* be held the same day as the previous
13+
iteration's debrief and retrospective meeting. Two intense meetings in a
14+
row tend to tire most humans out, and being tired is counterproductive
15+
for an effective meeting.
16+
17+
::: callout-note
18+
A basic agenda could be:
19+
20+
- Review and agree on the iteration aims and end date.
21+
- Review the longer-term roadmap
22+
- Review the list of tasks on the project board for this iteration.
23+
- Brainstorm and add any other issues as needed.
24+
:::
25+
26+
### Before meeting
27+
28+
In general, if you are not the team lead, you don't really need to
29+
prepare for this meeting. If you are the team lead though, you do need
30+
to prepare. So if you are the team lead:
31+
32+
- Before the planning meeting you need to refine (or create) the
33+
iteration aim(s) and move any existing tasks (GitHub Issues) into
34+
the iteration that are relevant to the aim(s) of the iteration. An
35+
iteration aim (or aims) should be something that is achievable
36+
within the iteration timeframe. The iteration should ideally have
37+
only a few main, larger aims, but can include a few more smaller
38+
aims.
39+
40+
- create any issues that are missing from the current list of issues.
41+
While making issues, keep them as small as is reasonable and as
42+
descriptive and targeted as possible.
43+
44+
If you are not the team lead, you can optionally review the aim(s) and
45+
output of the iteration board, review the list of issues already listed,
46+
and write out any potential issues as needed to complete the iteration
47+
aim.
48+
49+
### During meeting
50+
51+
During the meeting, someone will share their screen (if virtual) and the
52+
team will go through the tasks on the board together. Ideally, the team
53+
lead would be the one faciliatating the meeting, but it can be anyone.
54+
55+
You all will go over the roadmap or the longer term plan, to keep
56+
everyone aligned and updated. Then, you all will discuss and decide or
57+
agree on the iteration aim(s) (the "increment" or "milestone").
58+
59+
Finally, everyone will briefly review the current list of tasks on the
60+
board and brainstorm any other tasks that are needed. You'll agree on
61+
the number of tasks in the iteration as well as the distribution of
62+
priority labels of the tasks.
63+
64+
After that, you're done! Remember, this meeting is not meant to take up
65+
too much time.

0 commit comments

Comments
 (0)