From 803d743eca6344bd3b02ada9a7718475a7bd2d31 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Wed, 17 Apr 2024 08:31:49 -0500 Subject: [PATCH 1/9] RFC: Moving to UXL GitHub org --- rfc/001-changing-github-org.rst | 129 ++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 rfc/001-changing-github-org.rst diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst new file mode 100644 index 0000000..d72938b --- /dev/null +++ b/rfc/001-changing-github-org.rst @@ -0,0 +1,129 @@ +========================================== +Moving Projects to UXL GitHub Organization +========================================== + +Moving UXL projects from `oneapi-src`_ to an organization owned +by UXL. + +Background +========== + +All 6 of the original UXL projects are in the `oneapi-src`_ GitHub +organization. The org is owned by Intel and also contains projects that are not +part of UXL. We need to transfer ownership of the repos to UXL by moving them +to a new org. + +We considered various options: + +1. Move all the repos to the `uxlfoundation`_ org. +2. Move the oneapi-src org to UXL. +3. Move the repos to a project-specific org. + +We do not recommend (1) and (2) because they are a shared org. A shared org has +the following drawbacks: + +* Must share GitHub runners, permissions, and integrations +* Repo and team naming conflicts +* Community confusion. DPL and DNN have different communities and goals. +* Requires central management, and UXL does not have the resources to manage + the org + +Furthermore, (2) requires redefining the purpose of oneapi-src, which will lead +to confusion about the projects that go and stay. + +A shared org does have some advantages: + +* Central management can be more efficient and secure +* Sharing team definitions across projects when there are shared teams +* Provides more visibility for UXL as the host of the projects + +We recommend (3) because it is the common practice for large complex open +source projects. Projects will have the freedom to manage their org as they see +fit and not be affected by requirements or preferences of other projects. + +Proposed Org & Rep Names +======================== + +.. list-table:: + :header-rows: 1 + + * - Current Repo + - New Org + - New Repo + * - onednn + - onednn-project + - oneDNN + * - onedal + - onedal-project + - oneDAL + * - oneccl + - oneccl-project + - oneCCL + * - onemkl + - onemkl-project + - oneMKL-sycl-interfaces + * - onedpl + - onedpl-project + - oneDPL + * - onetbb + - onetbb-project + - oneTBB + +Org Administration +================== + +The projects will have ownership of their org. To ensure continuity, select at +least 2 people to have the org ``owner`` role. It is not recommended to broadly +share ownership permissions. Prepare a basic set of recommended configurations +(e.g. 2fa) for the org or perhaps the org can be configured before handover of +the project. Each org will be Linux Foundation and UXL admins who are there for +emergency maintenance only. Need to share some guides on how to manage an org. + +Process +======= + +This is a sketch of the activity. Each project should prepare its own schedule +and plan. Robert Dower, the maintainer of oneapi-src org will help with the +move by preparing the new org, transferring the teams, and moving the repos. + +Preparation: +1. Create the new org and teams +2. Prepare a project specific test plan +3. Prepare a project specific communication plan +4. Identify URLs that are not redirected and prepare PR's to update them. + +Execution: +1. Communicate the change to the community. +2. Move the repos to the new org. +3. Merge the PR's to update the URLs +4. Testing + +Cleanup: +1. Update URLs that are redirected + +Risks and Mitigations +===================== + +This section includes some generic risks. Each project should identify its own +risks. + +Community confusion + Communicate the change to the community and ensure that they understand the + new org structure and schedules. +Community disruption + Ensure that the new org has the same teams, permissions, and integrations as + the current org. Leverage GitHub repo URL redirect and provide website + redirects. +Maintainer disruption + Ensure that maintainers are aware of the change and have the necessary + permissions to continue their work. +CI/CD disruption + Test plan. Ensure the CI/CD maintainers are available to address problems. +Unexpected breakage + Test the new org before the move. Have a rollback plan in case of unexpected + breakage. Search the repos for references to the old org. +Release disruption + Schedule moves during a time when releases are not planned. + +.. _`uxlfoundation`: https://github.com/uxlfoundation +.. _`oneapi-src`: https://github.com/oneapi-src From 46fc15a2e5db65e5ec3b9e6fbfad9389e727f57e Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Mon, 29 Apr 2024 15:03:10 -0500 Subject: [PATCH 2/9] formatting fix --- rfc/001-changing-github-org.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index d72938b..52cdcd5 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -87,18 +87,21 @@ and plan. Robert Dower, the maintainer of oneapi-src org will help with the move by preparing the new org, transferring the teams, and moving the repos. Preparation: + 1. Create the new org and teams 2. Prepare a project specific test plan 3. Prepare a project specific communication plan 4. Identify URLs that are not redirected and prepare PR's to update them. Execution: + 1. Communicate the change to the community. 2. Move the repos to the new org. 3. Merge the PR's to update the URLs 4. Testing Cleanup: + 1. Update URLs that are redirected Risks and Mitigations From 7fb1e1a4a1702c77fda323c5c8dba8ecbba36b1a Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Fri, 3 May 2024 08:24:49 -0500 Subject: [PATCH 3/9] Add primary contacts and move date --- rfc/001-changing-github-org.rst | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index 52cdcd5..2e7b7c0 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -41,33 +41,52 @@ We recommend (3) because it is the common practice for large complex open source projects. Projects will have the freedom to manage their org as they see fit and not be affected by requirements or preferences of other projects. -Proposed Org & Rep Names -======================== +Repo Information +================ .. list-table:: :header-rows: 1 * - Current Repo + - Primary Contact + - Migration Date - New Org - New Repo * - onednn + - Vadim Pirogov + - - onednn-project - oneDNN * - onedal + - Nikolay Petrov + - - onedal-project - oneDAL * - oneccl + - Joel Rosenzweig + - - oneccl-project - oneCCL * - onemkl + - Irina Topinskaia + - - onemkl-project - oneMKL-sycl-interfaces * - onedpl + - Timmie Smith + - - onedpl-project - oneDPL * - onetbb + - Ekaterina Semenova + - - onetbb-project - oneTBB + * - oneapi-spec + - Robert Cohn + - 5/2/2024 + - uxlfoundation + - oneapi-spec Org Administration ================== From 13533b2f0c28ac16a0645024b984759d7c4c76ed Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Mon, 6 May 2024 12:22:07 -0500 Subject: [PATCH 4/9] Add TBB/DPL transition dates --- rfc/001-changing-github-org.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index 2e7b7c0..ff5f9cd 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -74,12 +74,12 @@ Repo Information - oneMKL-sycl-interfaces * - onedpl - Timmie Smith - - + - Q4 2024 - onedpl-project - oneDPL * - onetbb - Ekaterina Semenova - - + - Q4 2024 - onetbb-project - oneTBB * - oneapi-spec @@ -95,8 +95,9 @@ The projects will have ownership of their org. To ensure continuity, select at least 2 people to have the org ``owner`` role. It is not recommended to broadly share ownership permissions. Prepare a basic set of recommended configurations (e.g. 2fa) for the org or perhaps the org can be configured before handover of -the project. Each org will be Linux Foundation and UXL admins who are there for -emergency maintenance only. Need to share some guides on how to manage an org. +the project. Each org will have Linux Foundation and UXL admins who are there +for emergency maintenance only. Need to share some guides on how to manage an +org. Process ======= From 319214acb1ea472269fc25f34b53de2e9ff13b97 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Mon, 6 May 2024 12:44:50 -0500 Subject: [PATCH 5/9] Add more details about the moving process. --- rfc/001-changing-github-org.rst | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index ff5f9cd..da9d819 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -124,6 +124,39 @@ Cleanup: 1. Update URLs that are redirected +Moving the Repo +--------------- + +The recommended way to move the repo is to use the GitHub web interface to move +it to the new org. This will preserve the issues, PR's, and stars. The repo URL +will change, but GitHub will redirect the old URL to the new URL. Another +option is to fork the repo into the new org, but it will not do forwarding and +will not preserve the issues, PR's, and stars. + +It may be convenient to initially fork the repo to the new org for the purpose +of testing. I believe you can rename the repo in the new org to avoid confusion +about the active repo. Another possibility it to make the new repo private. In +either case, the fork would be deleted and the original repo moved. + +Robert Cohn has experience writing python scripts that use the GitHub APIs so +if there is some aspect of the move that you would like to automate, please let +him know. + +Project Web Sites +----------------- + +Most project web sites are hosted on GitHub pages. The URL is based on the org +and repo name. The URL will change when the repo is move. GitHub pages URLs are +not automatically forwarded, but we can manually forward individual URLs. + +Projects may want to consider moving their web site to a new URL that is not +based on the org and repo name. This will avoid the need to manually forward +URLs if the repo or org changes in the future. It also makes it possible to +change the web hosting provider without changing URLs. GitHub Pages is +preferred, but other providers allow dynamic content and bigger web sites. +Contact Robert Cohn to discuss web hosting if you want alternate hosting. + + Risks and Mitigations ===================== From 3f37fd8fcecc26e64a0196e2a07c0b73377e2048 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Tue, 7 May 2024 07:10:47 -0400 Subject: [PATCH 6/9] Add links to orgs --- rfc/001-changing-github-org.rst | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index da9d819..e457d5e 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -55,39 +55,47 @@ Repo Information * - onednn - Vadim Pirogov - - - onednn-project + - onednn-project_ - oneDNN * - onedal - Nikolay Petrov - - - onedal-project + - onedal-project_ - oneDAL * - oneccl - Joel Rosenzweig - - - oneccl-project + - oneccl-project_ - oneCCL * - onemkl - Irina Topinskaia - - - onemkl-project + - onemkl-project_ - oneMKL-sycl-interfaces * - onedpl - Timmie Smith - Q4 2024 - - onedpl-project + - onedpl-project_ - oneDPL * - onetbb - Ekaterina Semenova - Q4 2024 - - onetbb-project + - onetbb-project_ - oneTBB * - oneapi-spec - Robert Cohn - 5/2/2024 - - uxlfoundation + - uxlfoundation_ - oneapi-spec +.. _onednn-project: https://github.com/onednn-project +.. _onedal-project: https://github.com/onedal-project +.. _oneccl-project: https://github.com/oneccl-project +.. _onetbb-project: https://github.com/onetbb-project +.. _onedpl-project: https://github.com/onedpl-project +.. _onemkl-project: https://github.com/onemkl-project +.. _uxlfoundation: https://github.com/uxlfoundation + Org Administration ================== From 1cab41d333e9b4f9c9960da5a9a58ed87d0c8fc3 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Tue, 7 May 2024 07:16:17 -0400 Subject: [PATCH 7/9] add links to the repos --- rfc/001-changing-github-org.rst | 23 ++++++++++++++++------- 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index e457d5e..71b5128 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -52,32 +52,32 @@ Repo Information - Migration Date - New Org - New Repo - * - onednn + * - onednn_ - Vadim Pirogov - - onednn-project_ - oneDNN - * - onedal + * - onedal_ - Nikolay Petrov - - onedal-project_ - oneDAL - * - oneccl + * - oneccl_ - Joel Rosenzweig - - oneccl-project_ - oneCCL - * - onemkl + * - onemkl_ - Irina Topinskaia - - onemkl-project_ - oneMKL-sycl-interfaces - * - onedpl + * - onedpl_ - Timmie Smith - Q4 2024 - onedpl-project_ - oneDPL - * - onetbb + * - onetbb_ - Ekaterina Semenova - Q4 2024 - onetbb-project_ @@ -86,7 +86,7 @@ Repo Information - Robert Cohn - 5/2/2024 - uxlfoundation_ - - oneapi-spec + - oneapi-spec_ .. _onednn-project: https://github.com/onednn-project .. _onedal-project: https://github.com/onedal-project @@ -96,6 +96,15 @@ Repo Information .. _onemkl-project: https://github.com/onemkl-project .. _uxlfoundation: https://github.com/uxlfoundation +.. _onednn: https://github.com/oneapi-src/onednn +.. _onedal: https://github.com/oneapi-src/onedal +.. _oneccl: https://github.com/oneapi-src/oneccl +.. _onetbb: https://github.com/oneapi-src/onetbb +.. _onedpl: https://github.com/oneapi-src/onedpl +.. _onemkl: https://github.com/oneapi-src/onemkl +.. _oneapi-spec: https://github.com/uxlfoundation/oneapi-spec + + Org Administration ================== From c0dab1a4e3f0a4890caf2211039e99d52a0c4585 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Wed, 8 May 2024 10:32:14 -0400 Subject: [PATCH 8/9] adding completion dates for onemkl and onednn --- rfc/001-changing-github-org.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index 71b5128..3e47a50 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -54,7 +54,7 @@ Repo Information - New Repo * - onednn_ - Vadim Pirogov - - + - Q4 2024 - onednn-project_ - oneDNN * - onedal_ @@ -69,7 +69,7 @@ Repo Information - oneCCL * - onemkl_ - Irina Topinskaia - - + - Q4 2024 - onemkl-project_ - oneMKL-sycl-interfaces * - onedpl_ From 828c514ef24440159d1767a2feebd0c017706879 Mon Sep 17 00:00:00 2001 From: Robert Cohn Date: Tue, 28 May 2024 14:00:28 -0400 Subject: [PATCH 9/9] ccl/dal q4 2024 --- rfc/001-changing-github-org.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/rfc/001-changing-github-org.rst b/rfc/001-changing-github-org.rst index 3e47a50..4b473c4 100644 --- a/rfc/001-changing-github-org.rst +++ b/rfc/001-changing-github-org.rst @@ -59,12 +59,12 @@ Repo Information - oneDNN * - onedal_ - Nikolay Petrov - - + - Q4 2024 - onedal-project_ - oneDAL * - oneccl_ - Joel Rosenzweig - - + - Q4 2024 - oneccl-project_ - oneCCL * - onemkl_