|
| 1 | +--- |
| 2 | +title: "INF-NNNN - DXC Vulkan SDK Release Strategy" |
| 3 | +params: |
| 4 | + authors: |
| 5 | + - damyanp: Damyan Pepper |
| 6 | + sponsors: |
| 7 | + - damyanp: Damyan Pepper |
| 8 | + status: Under Consideration |
| 9 | +--- |
| 10 | + |
| 11 | +* Impacted Projects: DXC |
| 12 | + |
| 13 | +## Introduction |
| 14 | + |
| 15 | +DXC is included in the Vulkan SDK. Before each SDK release, the DXC submodule |
| 16 | +references (SPIRV-Headers, SPIRV-Tools) need to be updated and the product needs |
| 17 | +to be tested. This process has previously been mostly performed manually. This |
| 18 | +document details the requirements for ensuring DXC is ready for inclusion in the |
| 19 | +Vulkan SDK and proposes the changes required in order to satisfy them. |
| 20 | + |
| 21 | +## Motivation |
| 22 | + |
| 23 | +SPIRV-Headers and SPIRV-Tools need to be kept up to date so that the most recent |
| 24 | +SPIRV features are available in DXC. We need to verify that DXC is generating |
| 25 | +valid SPIRV code and that there are no regressions. The process needs to be |
| 26 | +documented and automated enough so that it does not rely on individuals with |
| 27 | +special knowledge. Additionally, we want to align the version included in the |
| 28 | +Vulkan SDK with a formal DXC release so that it matches up with GitHub and NuGet |
| 29 | +releases and can be ingested into Godbolt. |
| 30 | + |
| 31 | +## Proposed solution |
| 32 | + |
| 33 | +TODO |
| 34 | + |
| 35 | +<!-- Describe your solution to the problem. Provide examples and describe how |
| 36 | +they work. Show how your solution is better than current workarounds: is it |
| 37 | +cleaner, safer, or more efficient? --> |
| 38 | + |
| 39 | + |
| 40 | +<!-- |
| 41 | +
|
| 42 | +## Detailed design |
| 43 | +
|
| 44 | +_The detailed design is not required until the feature is under review._ |
| 45 | +
|
| 46 | +This section should grow into a full specification that will provide enough |
| 47 | +information for someone who isn't the proposal author to implement the feature. |
| 48 | +It should also serve as the basis for documentation for the feature. Each |
| 49 | +feature will need different levels of detail here, but some common things to |
| 50 | +think through are: |
| 51 | +
|
| 52 | +* Is there any potential for changed behavior? |
| 53 | +* Will this expose new interfaces that will have support burden? |
| 54 | +* How will this proposal be tested? |
| 55 | +* Does this require additional hardware/software/human resources? |
| 56 | +* What documentation should be updated or authored? |
| 57 | +
|
| 58 | +## Alternatives considered (Optional) |
| 59 | +
|
| 60 | +If alternative solutions were considered, please provide a brief overview. This |
| 61 | +section can also be populated based on conversations that occur during |
| 62 | +reviewing. |
| 63 | +
|
| 64 | +## Acknowledgments (Optional) |
| 65 | +
|
| 66 | +Take a moment to acknowledge the contributions of people other than the author |
| 67 | +and sponsor. |
| 68 | +
|
| 69 | +
|
0 commit comments