diff --git a/.github/ISSUE_TEMPLATE/agenda_item.md b/.github/ISSUE_TEMPLATE/agenda_item.md new file mode 100644 index 00000000..62c68d0b --- /dev/null +++ b/.github/ISSUE_TEMPLATE/agenda_item.md @@ -0,0 +1,19 @@ +--- +name: Design Meeting Agenda Item +about: Add an item to the next Design Meeting agenda +title: '' +labels: ['Design Meeting'] +assignees: ['llvm-beanz', 'farzonl'] + +--- + +**Does the agenda item relate to an existing proposal or specification language?** +Please link the file in the repo where the problem is documented. + +**Describe the issue or outstanding question.** +This can be as short as a question that needs answering or as complex as needed +to convey the problem that needs solving. + +**Additional context** +Add any other context or screenshots about the feature request here. + diff --git a/README.md b/README.md index 1177d99d..1df33983 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,13 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. +## Public Design Meeting + +The HLSL team organizes a meeting every two weeks which is open to the public to discuss work in progress in this repository. +That includes proposals for new HLSL features as well as the ongoing work to write a language specification. + +For more information on this meeting see the [Design Meeting](docs/DesignMeeting.md) documentation. + ## Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft diff --git a/docs/DesignMeeting.md b/docs/DesignMeeting.md new file mode 100644 index 00000000..2e74c157 --- /dev/null +++ b/docs/DesignMeeting.md @@ -0,0 +1,36 @@ +# Design Meeting + +> Notice: By participating in this meeting you are agreeing that all +> contributions you make on your own behalf or on behalf of your employer are +> subject to the terms of the +> [Microsoft Open Source Contributor License Agreement](https://opensource.microsoft.com/cla/). + +Public design meetings are held every other week (cancelling for holidays). +During these meetings the facilitator will iterate through PRs, issues and other +agenda topics to ensure forward progress and facilitate discussion. + +The meetings are facilitated by [Chris Bieneman](https://github.com/llvm-beanz) +and [Farzon Lotfi](https://github.com/farzonl). + +Meeting minutes will be posted into the [Meeting Minutes](docs/DesignMeetingMinutes) +folder of this repository following the [template](docs/DesignMeetingMinutes/Template.md). + +## Adding Agenda Items + +If there is an existing Issue or Pull Request you would like to discuss at the +next design meeting please add the +[Design Meeting](https://github.com/microsoft/hlsl-specs/labels/Design%20Meeting) +label. Issues and Pull Requests with the Design Meeting label will be given priority +during the meeting. + +If there is not an existing Issue or Pull request. File an issue with the +[Design Meeting Agenda Item](https://github.com/microsoft/hlsl-specs/issues/new?template=agenda_item.md) +template. + +## Attending the Meeting + +The design meeting is held using Microsoft Teams. + +If you wish to attend the meeting for an individual occurrence or on a recurring +basis, email [Ask HLSL @ Microsoft](mailto:AskHLSL@microsoft.com). Please +specify whether you want the recurring invite or a specific occurrence. diff --git a/docs/DesignMeetingMinutes/Template.md b/docs/DesignMeetingMinutes/Template.md new file mode 100644 index 00000000..29acfb03 --- /dev/null +++ b/docs/DesignMeetingMinutes/Template.md @@ -0,0 +1,7 @@ +# Design Meeting Minutes: YYYY/MM/DD + +> Notice: By participating in this meeting you are agreeing that all +> contributions you make on your own behalf or on behalf of your employer are +> subject to the terms of the +> [Microsoft Open Source Contributor License Agreement](https://opensource.microsoft.com/cla/). + diff --git a/docs/DesignMeetingMinutes/index.md b/docs/DesignMeetingMinutes/index.md new file mode 100644 index 00000000..30d4d9e9 --- /dev/null +++ b/docs/DesignMeetingMinutes/index.md @@ -0,0 +1,8 @@ +# Meeting Minute Index + +{% assign doclist = site.pages | sort: 'url' %} +{% for doc in doclist %} +{% if doc.name contains '.md' and doc.dir == '/docs/DesignMeetingMinutes/' and doc.name != 'index.md' %} +* [{{ doc.name }}]({{ doc.url | relative_url }}) +{% endif %} +{% endfor %}