Add Steering Committee meeting agenda process and tools#37
Open
makubacki wants to merge 1 commit into
Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces a documented ODP Steering Committee meeting agenda process and adds automation (GitHub Actions + a Python generator) to periodically create a new, pre-filled agenda markdown file from a template and TOML config.
Changes:
- Added a steering committee meeting process document describing agenda creation, finalization, cancellation, and minutes.
- Added agenda-generation tooling (
generate_agenda.py,config.toml,requirements.txt) plus an agenda template and directory README. - Added a scheduled GitHub Actions workflow to run the generator and open a PR when a new agenda is created.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
steering-committee-meetings/scripts/requirements.txt |
Adds Python dependencies for agenda generation. |
steering-committee-meetings/scripts/generate_agenda.py |
Implements agenda generation, recurrence calculation, and GitHub Actions output for automation. |
steering-committee-meetings/scripts/config.toml |
Defines meeting metadata and recurrence used by the generator. |
steering-committee-meetings/README.md |
Documents the meetings directory and manual generator usage. |
steering-committee-meetings/agenda-template.md |
Provides the canonical agenda template with placeholders and contributor guidance. |
STEERING-COMMITTEE-MEETING.md |
Defines the end-to-end meeting/agenda/minutes process. |
.github/workflows/create-meeting-agenda.yml |
Nightly workflow to run the generator and open a PR when an agenda is due. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Introduces the ODP Steering Committee meeting process, associated documentation, and automation tools. - `STEERING-COMMITTEE-MEETING.md`: Documents the agenda, cancellation, meeting, and follow-up process. - `steering-committee-meetings/agenda-template.md`: Agenda template. - `steering-committee-meetings/scripts/generate_agenda.py`: Generates an agenda from the template and config files. - `steering-committee-meetings/scripts/config.toml`: Meeting details. - `steering-committee-meetings/scripts/requirements.txt`: Python dependencies for the agenda generation script. - `steering-committee-meetings/README.md`: Directory overview and usage. - `.github/workflows/create-meeting-agenda.yml`: Nightly workflow that generates the next agenda when due and opens a pull request. Signed-off-by: Michael Kubacki <michael.kubacki@microsoft.com>
83f8924 to
5e648f5
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Introduces the ODP Steering Committee meeting process, associated documentation, and automation tools.
Primary Process Document
STEERING-COMMITTEE-MEETING.md: Documents the agenda, cancellation, meeting, and follow-up process.Agenda Automation Content
Summary: A GitHub workflow wraps a Python script to generate a blank agenda for an upcoming meeting. Nearly all logic is in the Python script since it is more maintainable that a workflow file. Basic info (like meeting chair, the Teams link, etc. is in config.toml). It only needs to be edited when that info changes. Once a month, a pull request will be created with a blank agenda file for the upcoming meeting. The date, time, and Teams link will be filled in. Once approved and checked in, new agenda items are added to the file manually by anyone with pull requests. Steering committee members approve pull requests, and the overall process follows that described in
STEERING-COMMITTEE-MEETING.md.steering-committee-meetings/agenda-template.md: Agenda template.steering-committee-meetings/scripts/generate_agenda.py: Generates an agenda from the template and config files.steering-committee-meetings/scripts/config.toml: Meeting details used to create the upcoming agenda.steering-committee-meetings/scripts/requirements.txt: Python dependencies for the agenda generation script..github/workflows/create-meeting-agenda.yml: Nightly workflow that generates the next agenda when due and opens a pull request.Miscellaneous Docs
steering-committee-meetings/README.md: Brief information on directory overview and usage.