Note-taking process

We’ve come up with a process for taking notes at a governance and risk meeting to ensure accuracy, readability and consistency. Here’s how it goes.

Roles

Note-taking is at least a two person job and involves writers and a reviewer.

Writer

Takes initial notes, screenshots, and fixes notes in post-editing with the availability of the recording.

We recommend at least two people do this role, splitting up the work for the entire summary. Multiple writers have the advantage of supporting each other with formatting, screenshots, and quality assurance on sections that they are not taking the initial notes on. Writers use the :hand:(🤚) symbol during live calls to request help from another writer.

Reviewer

Sets up the initial working doc, does a full review of the summary after it's produced, quality checks for formatting and semantic errors, and also submits the final version of the summary to GitHub and the Forum.

Recommended to be done by one person.

1. Reviewer prepares working doc

Create a new doc in HackMD using the template and send it to the writers.

Governance call notes template

2. Writers take notes

Make sure you have the HackMD document to hand and join the governance call.

View calendar invite ↗

If you’re working with someone else on writing the notes, make sure you’ve decided which sections each of you will focus on. We recommend staying in contact with your fellow writers throughout the call.

3. Writers review their notes

Once the call is over skim the working doc and fix any obvious errors.

4. Writers complete their notes with recording

Once you’ve received the recording you can complete the summary by:

  • adding time-anchored-links

  • adding relevant links

  • fixing unclear or unfinished notes.

Let the reviewer know once you’re finished with this.

5. Reviewer double checks the notes

You should review the notes thoroughly. Make sure they're formatted correctly.

Formatting guide

6. Reviewer submits a pull request

You should submit a singe pull request to the MakerDAO community repository ↗

Your pull request should:

7. Reviewer submits summary on forum thread

Once the pull request has been submitted, you should comment on the call’s forum thread with a link to the summary.

Helpful resources

Summaries

See examples of complete summaries to see what a finished summary looks like.

Summaries

Frequent topics

Get prepared by looking at some of the topics that we discuss regularly.

Frequent Discussion Topics

Note-taking template

This is the template for taking notes at a governance meeting. Follow this to ensure consistency.

Governance call notes template

Last updated

Was this helpful?