Integrate the specification into the oneDPL documentation#2640
Integrate the specification into the oneDPL documentation#2640
Conversation
| .. SPDX-FileCopyrightText: 2019-2022 Intel Corporation | ||
| .. SPDX-FileCopyrightText: Contributors to the oneAPI Specification project. | ||
| .. |
There was a problem hiding this comment.
These two copyright notices are consistent within the oneDPL specification, with two exceptions:
sycl_kernels_api.rstmisses the "contributors" notice;parallel_range_api.rstmisses the Intel Corporation notice
The marked change addresses the first one, but the second one is I believe intentional. The logic behind this is that after 2022 Intel acted as one but not the only contributor to the specification (technically, though, all modifications of the oneDPL spec came from Intel, according to the commit log). Since the parallel range algorithms were added to the spec only in 2024, there is no Intel copyright notice.
Perhaps it makes sense to change the second notice to "UXL Foundation Contributors". As for the years in the first notice, I think we can either leave these as-is, change to 2019-2023 (assuming that it's transmitted to UXL then), or change to the year of the last modification. I have some preference for 2023.
5efe187 to
05c6d60
Compare
| ====== | ||
| oneDPL | ||
| ====== | ||
| This is the specification of |onedpl_long|, version 1.5-provisional. |
There was a problem hiding this comment.
I think this document is best positioned as a provisional specification at this point, There is still at least one change in progress, and generally, I think we need some formal decision to "release" the new specification.
On top of #2621, this PR makes changes to build the oneDPL specification as part of the overall project documentation.