Prepending to Living Agenda Documents

Brett RowberryBrett Rowberry
2 min read

Imagine you have a recurring meeting with an agenda open to contributions by all participants. Many meetings in the workplace are like this:

  • 1:1s

  • Sprint demos

  • Team operational reviews

Perhaps the agenda is written in a Google Doc or a Confluence page. Say have your first meeting on January 3rd. The document will look something like this:

# January 3rd
- Party cleanup (10 minutes)
- Goal review (20 minutes)

Here’s the living agenda document for January 10th:

# January 3rd
- Party cleanup (10 minutes)
- Goal review (20 minutes)

# January 10th
- Printer paper (5 minutes)
- Lunch menu (15 minutes)

You may notice a pattern. Each meeting, the latest agenda gets lower on the page. By the fifth meeting or so, the scrolling becomes tedious.

Enter prepending! It looks like this:

# January 10th
- Printer paper (5 minutes)
- Lunch menu (15 minutes)

# January 3rd
- Party cleanup (10 minutes)
- Goal review (20 minutes)

Enjoy!

For the computer scientists out there, note that the most common access patterns are:

  • peeking the top item, and

  • pushing a new top item.

That sounds like a stack! That’s why it’s better to prepend to the agenda. It’s more efficient to access the head of a linked list, O(1), than the tail, O(n). That’s not entirely true since you can hit Command + Down on Mac or End on Windows to jump to the bottom of a document in a browser, but not everyone knows that!

0
Subscribe to my newsletter

Read articles from Brett Rowberry directly inside your inbox. Subscribe to the newsletter, and don't miss out.

Written by

Brett Rowberry
Brett Rowberry

I like programming (at work) and learning for fun. You'll often find me cooking and working on my house in my spare time.