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 template2. Writers take notes
Make sure you have the HackMD document to hand and join the governance call.
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 guide6. Reviewer submits a pull request
You should submit a singe pull request to the MakerDAO community repository ↗
Your pull request should:
add the summary as a new file in the summaries folder ↗
add a link to the new file in the summaries
README.md
file ↗add a link to the new file in community repo's
SUMMARY.md
file ↗
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.
SummariesFrequent topics
Get prepared by looking at some of the topics that we discuss regularly.
Frequent Discussion TopicsNote-taking template
This is the template for taking notes at a governance meeting. Follow this to ensure consistency.
Governance call notes templateLast updated
Was this helpful?