2018-01-04 21:55:26 +00:00
|
|
|
|
## Vulkan Loader and Validation Layers Repository Management
|
|
|
|
|
|
|
|
|
|
# **Open Source Project <20> Objectives**
|
|
|
|
|
|
|
|
|
|
* Alignment with the Vulkan Specification
|
|
|
|
|
- The goal is for validation layer behavior to enforce the vulkan specification on applications. Questions on specification
|
2018-01-08 15:05:37 +00:00
|
|
|
|
interpretations may require consulting with the Khronos Vulkan Workgroup for resolution
|
2018-01-04 21:55:26 +00:00
|
|
|
|
- [Core Specification](https://www.khronos.org/registry/vulkan/specs/1.0/html/vkspec.html)
|
|
|
|
|
- [Header Files](https://www.khronos.org/registry/vulkan/#headers)
|
|
|
|
|
- [SDK Resources](https://vulkan.lunarg.com)
|
|
|
|
|
* ISV Enablement
|
|
|
|
|
- Updates of loader and validation layer functionality should be available in a timely fashion
|
|
|
|
|
- Every effort will be made to be responsive to ISV issues with validation layers
|
|
|
|
|
* Cross Platform Compatibility
|
|
|
|
|
- Google and LunarG collaboration:
|
|
|
|
|
- Google: Monitor for Android
|
|
|
|
|
- LunarG: Monitor for desktop (Windows and Linux)
|
2018-01-04 23:12:41 +00:00
|
|
|
|
- Continuous Integration: HW test farms operated by Google and LunarG monitor various hardware/software platforms
|
2018-01-04 21:55:26 +00:00
|
|
|
|
* Repo Quality
|
|
|
|
|
- Repo remains in healthy state with all tests passing and good-quality, consistent codebase
|
2018-01-04 23:12:41 +00:00
|
|
|
|
- Continuous Integration: Along with Github, HW test farms operated by Google and LunarG perform pre-commit cloud testing
|
|
|
|
|
on pull-requests
|
2018-01-04 21:55:26 +00:00
|
|
|
|
|
|
|
|
|
# **Roles and Definitions**
|
|
|
|
|
* Contributor, Commenter, User
|
2018-01-04 23:12:41 +00:00
|
|
|
|
- Submitting contributions, creating issues, or using the contents of the repository
|
2018-01-04 21:55:26 +00:00
|
|
|
|
* Approver
|
2018-01-08 15:05:37 +00:00
|
|
|
|
- Experienced project members who have made significant technical contributions
|
2018-01-04 23:12:41 +00:00
|
|
|
|
- Write control: Approve pull/merge requests (verify submissions vs. acceptance criteria)
|
2018-01-04 21:55:26 +00:00
|
|
|
|
* Technical Project Leads
|
2018-01-08 15:05:37 +00:00
|
|
|
|
- Lead the project in terms of versioning, quality assurance, and overarching objectives
|
2018-01-04 21:55:26 +00:00
|
|
|
|
- Monitor github issues and drive timely resolution
|
2018-01-08 15:05:37 +00:00
|
|
|
|
- Designate new approvers
|
2018-01-04 21:55:26 +00:00
|
|
|
|
- Ensure project information such as the Readme, Contributing docs, wiki, etc., kept up-to-date
|
|
|
|
|
- Act as a facilitator in resolving technical conflicts
|
|
|
|
|
- Is a point-of-contact for project-related questions
|
|
|
|
|
|
|
|
|
|
The technical project leads for this repository are:
|
|
|
|
|
* **Mark Lobodzinski** [mark@lunarg.com](mailto:mark@lunarg.com)
|
|
|
|
|
* **Tobin Ehlis** [tobine@google.com](mailto:tobine@google.com)
|
|
|
|
|
|
2018-01-08 15:05:37 +00:00
|
|
|
|
# **Acceptance Criteria and Process**
|
|
|
|
|
- All source code to include Khronos copyright and license (Apache 2.0).
|
|
|
|
|
- Additional copyrights of contributors appended
|
2018-01-04 21:55:26 +00:00
|
|
|
|
- Contributions are via pull requests
|
|
|
|
|
- Project leads will assigning approvers to contributor pull requests
|
|
|
|
|
- Approvers can self-assign their reviewers
|
|
|
|
|
- For complex or invasive contributions, Project Leads may request approval from specific reviewers
|
|
|
|
|
- At least one review approval is required to complete a pull request
|
|
|
|
|
- The goal is to be responsive to contributors while ensuring acceptance criteria is met and to facilitate their submissions
|
|
|
|
|
- Approval is dependent upon adherence to the guidelines in [CONTRIBUTING.md](CONTRIBUTING.md), and alignment with
|
|
|
|
|
repository goals of maintainability, completeness, and quality
|
|
|
|
|
- Conflicts or questions will ultimately be resolved by the project leads
|