(Secretary) Taking Board Meeting Minutes

Minutes Location

Minutes for board meetings are made public on our main website.

The repo for the website has a folder, _minutes. Each file in this page is individually rendered into a minutes page on the final website.

Adding New Minutes

Website updates happen automatically with updates to the repo.

You can add new minutes files using the github workflow of your choice (text editor + git), or by editing the markdown files as plain text directly from Github. To help organize files, please follow the existing filename convention, Board-YYYY-MM-DD.md, which will make the files sort chronologically by default.

Minutes File Format

Each minutes file has to have a header with a certain format. This is best done by copying the header from a previous minutes file and modifying the title, date, and excerpt fields.

The rest of the minutes file is written in markdown, which enables formatting that works well when rendered to the final web page, or in plain text. Here is a guide on markdown syntax.

There is no specified format, but I strongly recommend following the existing files for consistency with a section for Attendees, Agenda, Notes, and Action Items.

Debugging

If minutes do not show up immediately, then there is likely an issue with the formatting of the header. Check that the punctuation, etc. is correct (an easy way is to look at an older minutes file that works).