Skip to content

Commit 8515cdd

Browse files
committed
Merge branch 'develop' into cufft-update-host-task
2 parents cdb496c + b2324f1 commit 8515cdd

File tree

113 files changed

+11258
-5498
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

113 files changed

+11258
-5498
lines changed

CONTRIBUTING.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ Before sending your pull requests, ensure that you follow this checklist:
1515

1616
* Ensure that [unit tests](CONTRIBUTING.md#unit-tests) pass. Include logs from tests as attachments to the pull request.
1717

18+
* Ensure that corresponding [maintainer GitHub team](#onemkl-interfaces-maintainers) is assigned to the PR review.
19+
1820
## Library Functionality Guidelines
1921

2022
oneMKL focuses on the following criteria:
@@ -45,6 +47,7 @@ Please also provide the following details as part of the RFC:
4547

4648
* What existing libraries have implementations of this function and can be used under the oneMKL interface.
4749

50+
* Ensure that corresponding [maintainer GitHub team](#onemkl-interfaces-maintainers) is assigned to the RFC review.
4851

4952
## Bug Reporting
5053

@@ -55,6 +58,22 @@ If you find a bug or problem, please open a request under [Issues](https://githu
5558

5659
Report security issues to [email protected].
5760

61+
## oneMKL Interfaces Maintainers
62+
63+
For GitHub questions, issues, RFCs, or PRs you can contact maintainers via one of the following GitHub teams based on the topic:
64+
65+
| GitHub team name | Description |
66+
:-----------|:------------|
67+
| @oneapi-src/onemkl-maintain | All oneMKL Interfaces maintainers |
68+
| @oneapi-src/onemkl-arch-write | oneMKL Interfaces Architecture maintainers |
69+
| @oneapi-src/onemkl-blas-write | oneMKL Interfaces BLAS maintainers |
70+
| @oneapi-src/onemkl-dft-write | oneMKL Interfaces DFT maintainers |
71+
| @oneapi-src/onemkl-lapack-write | oneMKL Interfaces LAPACK maintainers |
72+
| @oneapi-src/onemkl-rng-write | oneMKL Interfaces RNG maintainers |
73+
| @oneapi-src/onemkl-sparse-write | oneMKL Interfaces Sparse Algebra maintainers |
74+
| @oneapi-src/onemkl-vm-write | oneMKL Interfaces Vector Math maintainers |
75+
76+
Please read [MAINTAINERS page](MAINTAINERS.md) for more information about maintainer roles, responsibilities, and how to become one of them.
5877

5978
## Coding Style
6079

MAINTAINERS.md

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
# Introduction
2+
3+
This document defines roles in oneMKL Interfaces project.
4+
5+
# Roles and responsibilities
6+
7+
oneMKL Interfaces project defines three main roles:
8+
* [Contributor](#contributor)
9+
* [Domain maintainer](#domain-maintainer)
10+
* [Architecture maintainer](#architecture-maintainer)
11+
12+
These roles are merit based. Refer to the corresponding section for specific
13+
requirements and the nomination process.
14+
15+
## Contributor
16+
17+
A Contributor invests time and resources to improve oneMKL Interfaces project.
18+
Anyone can become a Contributor by bringing value in one of the following ways:
19+
* Answer questions from community members.
20+
* Submit feedback to design proposals.
21+
* Review and/or test pull requests.
22+
* Test releases and report bugs.
23+
* Contribute code, including bug fixes, features implementations,
24+
and performance optimizations.
25+
* Contribute design proposals.
26+
27+
Responsibilities:
28+
* Follow the [Code of Conduct](CODE_OF_CONDUCT.md).
29+
* Follow the project [contributing guidelines](CONTRIBUTING.md).
30+
31+
Privileges:
32+
* Eligible to join one of the maintainer groups.
33+
34+
## Domain Maintainer
35+
36+
Domain maintainer has responsibility for a specific domain in the project.
37+
Domain maintainers are collectively responsible for developing and maintaining their domain,
38+
including reviewing all changes to their domain and indicating
39+
whether those changes are ready to merge. They have a track record of
40+
contribution and review in the project.
41+
42+
Responsibilities:
43+
* Follow the [Code of Conduct](CODE_OF_CONDUCT.md).
44+
* Follow and enforce the project [contributing guidelines](CONTRIBUTING.md).
45+
* Co-own with other domain maintainers a specific domain, including contributing
46+
bug fixes, implementing features, and answering domain specific questions
47+
in [#onemkl](https://uxlfoundation.slack.com/archives/onemkl) Slack channel.
48+
* Review pull requests in their specific domain.
49+
* Monitor testing results and flag issues in their specific areas of
50+
responsibility.
51+
* Support and guide Contributors.
52+
53+
Requirements:
54+
* Experience as Contributor in the specific domain for at least 6 months.
55+
* Commit at least 25% of working time to the project.
56+
* Track record of accepted code contributions to a specific domain.
57+
* Track record of contributions to the code review process.
58+
* Demonstrated in-depth knowledge of the specific domain.
59+
* Commits to being responsible for that specific domain.
60+
61+
Privileges:
62+
* PR approval counts towards approval requirements for a specific domain.
63+
* Can promote fully approved Pull Requests to the `develop` branch.
64+
* Can recommend Contributors to become Domain maintainer.
65+
* Eligible to become an Architecture maintainer.
66+
67+
The process of becoming a Domain maintainer is:
68+
1. A Contributor requests to join corresponding Domain maintainer GitHub team.
69+
2. At least one specific Domain maintainers approve the request.
70+
71+
### List of GitHub teams for Domain maintainers
72+
73+
| GitHub team name | Domain maintainers |
74+
:-----------|:------------|
75+
| @oneapi-src/onemkl-blas-write | oneMKL Interfaces BLAS maintainers |
76+
| @oneapi-src/onemkl-dft-write | oneMKL Interfaces DFT maintainers |
77+
| @oneapi-src/onemkl-lapack-write) | oneMKL Interfaces LAPACK maintainers |
78+
| @oneapi-src/onemkl-rng-write | oneMKL Interfaces RNG maintainers |
79+
| @oneapi-src/onemkl-sparse-write | oneMKL Interfaces Sparse Algebra maintainers |
80+
| @oneapi-src/onemkl-vm-write | oneMKL Interfaces Vector Math maintainers |
81+
82+
## Architecture Maintainer
83+
Architecture maintainers are the most established contributors who are responsible for the
84+
project technical direction and participate in making decisions about the
85+
strategy and priorities of the project.
86+
87+
Responsibilities:
88+
* Follow the [Code of Conduct](CODE_OF_CONDUCT.md).
89+
* Follow and enforce the project [contributing guidelines](CONTRIBUTING.md)
90+
* Co-own with other Domain maintainers on the technical direction of a specific domain.
91+
* Co-own with other Architecture maintainers on the project as a whole, including
92+
determining strategy and policy for the project.
93+
* Support and guide Contributors and Domain maintainers.
94+
95+
Requirements:
96+
* Experience as a Domain maintainer or Contributor with focus on the project architecture
97+
for at least 12 months.
98+
* Commit at least 25% of working time to the project.
99+
* Track record of major project contributions.
100+
* Demonstrated deep knowledge of the project architecture and build.
101+
* Demonstrated broad knowledge of the project across multiple domains.
102+
* Is able to exercise judgment for the good of the project, independent of
103+
their employer, friends, or team.
104+
105+
Privileges:
106+
* Can represent the project in public as a Maintainer.
107+
* Can recommend Contributor or Domain maintainer to become Architecture maintainers.
108+
109+
Process of becoming a maintainer:
110+
1. A Contributor or Domain maintainer requests to join oneMKL Interfaces Architecture maintainers GitHub team
111+
(@oneapi-src/onemkl-arch-write).
112+
2. At least one of Architecture maintainers approves the request.
113+

README.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ oneMKL is part of the [UXL Foundation](http://www.uxlfoundation.org).
6262
</tr>
6363
<tr>
6464
<td align="center"><a href="https://github.com/codeplaysoftware/portBLAS"> portBLAS </a></td>
65-
<td align="center">x86 CPU, Intel GPU, NVIDIA GPU, AMD GPU</td>
65+
<td align="center">x86 CPU, Intel GPU, NVIDIA GPU, AMD GPU, Other SYCL devices (unsupported)</td>
6666
</tr>
6767
<tr>
6868
<td align="center"><a href="https://github.com/codeplaysoftware/portFFT"> portFFT </a></td>
@@ -172,7 +172,7 @@ Supported compilers include:
172172
</thead>
173173
<tbody>
174174
<tr>
175-
<td rowspan=9 align="center">BLAS</td>
175+
<td rowspan=10 align="center">BLAS</td>
176176
<td rowspan=3 align="center">x86 CPU</td>
177177
<td align="center">Intel(R) oneMKL</td>
178178
<td align="center">Intel DPC++</br>AdaptiveCpp</td>
@@ -221,6 +221,12 @@ Supported compilers include:
221221
<td align="center">Open DPC++</td>
222222
<td align="center">Dynamic, Static</td>
223223
</tr>
224+
<tr>
225+
<td rowspan=1 align="center">Other SYCL devices (unsupported)</td>
226+
<td align="center">portBLAS</td>
227+
<td align="center">Intel DPC++</br>Open DPC++</td>
228+
<td align="center">Dynamic, Static</td>
229+
</tr>
224230
<tr>
225231
<td rowspan=4 align="center">LAPACK</td>
226232
<td align="center">x86 CPU</td>
@@ -405,6 +411,7 @@ Supported compilers include:
405411
- Intel(R) Data Center GPU Max Series
406412
- NVIDIA(R) A100 (Linux* only)
407413
- AMD(R) GPUs see [here](https://github.com/RadeonOpenCompute/ROCm#hardware-and-software-support) tested on AMD Vega 20 (gfx906)
414+
- Other SYCL devices can be used, but are not supported
408415

409416
---
410417
### Supported Operating Systems
@@ -546,19 +553,6 @@ You can also join the mailing lists for the [UXL Foundation](https://lists.uxlfo
546553

547554
You can contribute to this project and also contribute to [the specification for this project](https://oneapi-spec.uxlfoundation.org/specifications/oneapi/latest/elements/onemkl/source/). Please read the [CONTRIBUTING](CONTRIBUTING.md) page for more information. You can also contact oneMKL developers and maintainers via [UXL Foundation Slack](https://slack-invite.uxlfoundation.org/) using [#onemkl](https://uxlfoundation.slack.com/archives/onemkl) channel.
548555

549-
For GitHub questions, issues, RFCs, or PRs you can contact maintainers via one of the following GitHub teams based on the topic:
550-
551-
| GitHub team name | Description |
552-
:-----------|:------------|
553-
| @oneapi-src/onemkl-maintain | All oneMKL maintainers |
554-
| @oneapi-src/onemkl-arch-write | oneMKL Architecture maintainers |
555-
| @oneapi-src/onemkl-blas-write | oneMKL BLAS maintainers |
556-
| @oneapi-src/onemkl-dft-write | oneMKL DFT maintainers |
557-
| @oneapi-src/onemkl-lapack-write) | oneMKL LAPACK maintainers |
558-
| @oneapi-src/onemkl-rng-write | oneMKL RNG maintainers |
559-
| @oneapi-src/onemkl-sparse-write | oneMKL Sparse Algebra maintainers |
560-
| @oneapi-src/onemkl-vm-write | oneMKL Vector Math maintainers |
561-
562556
---
563557

564558
## License

0 commit comments

Comments
 (0)