From 371670004749f993826480b8ddf2f65e01d69de4 Mon Sep 17 00:00:00 2001 From: asteiker Date: Tue, 30 Sep 2025 19:11:53 +0000 Subject: [PATCH 1/5] add pros cons and historical context --- .../decisions/929-move-repository.md | 110 ++++++++++++------ 1 file changed, 75 insertions(+), 35 deletions(-) diff --git a/docs/governance/decisions/929-move-repository.md b/docs/governance/decisions/929-move-repository.md index 5adce98f..b130524d 100644 --- a/docs/governance/decisions/929-move-repository.md +++ b/docs/governance/decisions/929-move-repository.md @@ -1,7 +1,7 @@ # Decision Record: [#929 Move or fork to independent organization](https://github.com/nsidc/earthaccess/issues/929) - Status: Ready for Review -- Deciders: @jhkennedy, @chuckwondo, @mfisher87, @Sherwin-14, @asteiker, @itcarroll +- Deciders: @jhkennedy, @chuckwondo, @mfisher87, @Sherwin-14, @asteiker, @itcarroll, @danielfromearth - Date: 2025-07-08 @@ -16,7 +16,7 @@ organization, GitHub's design prevents us from administrating our project independently. For example, we require organization owner permission for certain actions, teams are managed at the organization level, and our project is mixed with a large number of other projects (making it less discoverable). -Moving the `earthaccess` repo to another GitHub organization will: +In order to strengthen the community engagement of earthaccess and lower participation barriers, moving the `earthaccess` repo to another GitHub organization will: * Reduce friction to collaboration by allowing us to self-determine our community members' access and privileges. @@ -27,51 +27,91 @@ Moving the `earthaccess` repo to another GitHub organization will: * Preserve community's ability to make its own decisions independent of institutional structure and policy. -Overall: enhance collaboration, efficiency, and longevity -In order to strengthen the community engagement of earthaccess and lower participation barriers, moving to a - -Bullets from presentation to ESDIS on 2/11/2025: -- Accelerate development via broader participation -- Lower the cost:value even further for ESDIS -- Promote NASA’s partners - -* Co-location with other similar projects (including similar resources in other languages, e.g. R and Julia) -* Meeting users where they are -* Increase visibility, ability to promote, bring awareness to a broader community (e.g. Pangeo showcase) -* Meets NASA Open Source Science goals -* Leveraging NUMFocus sponsorship could allow for Google Summer of Code mentorship and other funding/effort contributions -* Promotes NASA’s partnerships with other community members based on shared goals, by actively recognizing the critical * contributions of those members. -* From some Googling: -* Flexibility -* Rapid innovation -* Improved security through rapid bug fixes -* Transparency and trust -* Cost efficiency -* Development driver by the user community -* While inter-community support reduces ESDIS/NASA required support, we acknowledge that increased ESDIS funding will also help us sustain the library -hips with other community members based on shared goals -- Increase sustainability +### Historical Context +A presentation by several earthaccess maintainers to NASA ESDIS on 2/11/2025 provided additional context and benefits of "repotting" the earthaccess repository, in order to learn more about their stance on moving and how this might impact future funding opportunities. This presentation highlighted other key benefits of repotting the repository, including: +* Accelerating development via broader participation +* Lower the cost:value even further for NASA ESDIS by enabling rapid innovation and improved security through rapid bug fixes +* Promote NASA’s partnerships with other community members based on shared goals, by actively recognizing the critical contributions of those members and increasing transparency and trust. +* Meet NASA Open Source Science goals + +An outcome of this meeting was to pursue a cross-DAAC proposal for sustained ESDIS funding, retaining the existing community ownership model while enhancing and amplifying the communication of feature development across the earthaccess community and ESDIS. While inter-community support reduces ESDIS/NASA required support, we acknowledge that increased ESDIS funding will also help us sustain the library. Although a draft was developed, ESDIS asked for this effort to be paused in summer 2025. Regardless of the approach we choose, we will continue acknowledging ESDIS support through our ESDIS-funded contributors and the facilitation role of NASA Openscapes. + +While earthaccess is listed by ESDIS as an approved Enterprise Solution, earthaccess is not part of ESDIS convergence... + + +### Migration effort tasks + +Options 2 and 3 below would involve the movement of the existing earthaccess repository into another GitHub organization. + +Transferring a GitHub repository to another organization involves several impacts and considerations: +1. Repository URL and Local Clones: +The repository's URL will change to reflect the new organization. +GitHub provides redirects from the old URL, but it is recommended to update local clones to point to the new URL using git remote set-url origin NEW-URL to avoid potential issues and confusion. +2. Permissions and Access: +Permissions and access settings will need to be reconfigured within the new organization. +Team members who previously had access may need to be granted access to the repository within the new organization's structure. +3. Integrations and Third-Party Tools: +Any integrations or third-party tools connected to the repository (e.g., CI/CD pipelines, project management tools) may be affected. +These tools will likely need to be updated or reconfigured to work with the repository's new location and potentially different access tokens or settings. +4. Issues, Pull Requests, and Project Details: +All existing issues, pull requests, and other project details (e.g., commit history, branches) will be transferred with the repository and remain intact. +However, if you are using classic GitHub Projects tied to the repository, they will not transfer and references to issues/PRs within them may break. New GitHub Projects (beta) issues will remain but may need manual re-association. +5. GitHub Pages: +Links to the Git repository on the web and through Git activity will be redirected if the repository contains a GitHub Pages site. +However, the GitHub Pages site itself is not automatically redirected and may need manual adjustment or recreation in the new organization's context. +6. Forks: +If the repository was forked from a private upstream network, it cannot be transferred. +If the target organization already has a fork of the repository, the transfer cannot proceed. +7. Packages: +Packages associated with the repository may or may not transfer or retain their link, depending on the registry they belong to. Permissions for GitHub Packages should be reviewed. +8. Notifications: +Users who previously interacted with the repository will receive a notification that the repository has been moved. + +What are the things that don't need to be migrated + +Issues, PRs, etc. ## Considered Options -? +### Option 1: Don't move; stay within `nsidc` org. +Pros: +* No migration effort (and associated disruption) needed -## Decision Outcome +Cons: +* No clear path to extend organizational ownership permissions to earthaccess maintainers outside of NSIDC + +### Option 2: Move to an independent org, e.g. `earthaccess-dev`. + +Pros: +* Full / flexible community governance +* Custom branding? + +Cons: +* Migration effort +* Potential for reduced visibility without institutional org backing? -? +### Option 3: Move to a sponsor / incubator org, e.g. `pangeo`, `openscapes`. -### Option 1 +Pros: +* Built-in open source credibility and visibility +* Leverage existing communities, increased contributor base? +* Leverage existing software infrastructure?, +* Leverage existing governance models? +* Potential funding opportunities? +Cons: +* Migration effort +* Less control over organizationl decisions/policies/memership? +* May need to align with existing organization's priorities and processes -Don't move; stay within `nsidc` org. -### Option 2 -Move to an independent org, e.g. `earthaccess-dev`. +## Decision Outcome + +? + -### Option 3 -Move to a sponsor / incubator org, e.g. `pangeo`. From d4ab72ceead953a1af7dd5629f7400dbb7cb4280 Mon Sep 17 00:00:00 2001 From: asteiker Date: Tue, 30 Sep 2025 23:22:44 +0000 Subject: [PATCH 2/5] add migration impacts --- .../decisions/929-move-repository.md | 78 +++++++++---------- 1 file changed, 39 insertions(+), 39 deletions(-) diff --git a/docs/governance/decisions/929-move-repository.md b/docs/governance/decisions/929-move-repository.md index b130524d..950305be 100644 --- a/docs/governance/decisions/929-move-repository.md +++ b/docs/governance/decisions/929-move-repository.md @@ -2,7 +2,7 @@ - Status: Ready for Review - Deciders: @jhkennedy, @chuckwondo, @mfisher87, @Sherwin-14, @asteiker, @itcarroll, @danielfromearth -- Date: 2025-07-08 +- Date: 2025-07-08; modified 2025-09-30 Technical Story: [#929 Move or fork to independent organization](https://github.com/nsidc/earthaccess/issues/929) @@ -29,49 +29,46 @@ In order to strengthen the community engagement of earthaccess and lower partici ### Historical Context -A presentation by several earthaccess maintainers to NASA ESDIS on 2/11/2025 provided additional context and benefits of "repotting" the earthaccess repository, in order to learn more about their stance on moving and how this might impact future funding opportunities. This presentation highlighted other key benefits of repotting the repository, including: +A presentation by several earthaccess maintainers to NASA ESDIS on 11 February 2025 provided additional context and benefits of "repotting" the earthaccess repository, in order to learn more about their stance on moving and how this might impact future funding opportunities. This presentation highlighted other key benefits of repotting the repository, including: -* Accelerating development via broader participation -* Lower the cost:value even further for NASA ESDIS by enabling rapid innovation and improved security through rapid bug fixes -* Promote NASA’s partnerships with other community members based on shared goals, by actively recognizing the critical contributions of those members and increasing transparency and trust. -* Meet NASA Open Source Science goals - -An outcome of this meeting was to pursue a cross-DAAC proposal for sustained ESDIS funding, retaining the existing community ownership model while enhancing and amplifying the communication of feature development across the earthaccess community and ESDIS. While inter-community support reduces ESDIS/NASA required support, we acknowledge that increased ESDIS funding will also help us sustain the library. Although a draft was developed, ESDIS asked for this effort to be paused in summer 2025. Regardless of the approach we choose, we will continue acknowledging ESDIS support through our ESDIS-funded contributors and the facilitation role of NASA Openscapes. - -While earthaccess is listed by ESDIS as an approved Enterprise Solution, earthaccess is not part of ESDIS convergence... +* Accelerating development via broader participation. +* Lowering the cost:value even further for NASA ESDIS by enabling rapid innovation and improved security through rapid bug fixes. +* Promoting NASA’s partnerships with other community members based on shared goals, by actively recognizing the critical contributions of those members and increasing transparency and trust. +* Meeting NASA Open Source Science goals. +Subsequent discussion included positive feedback from ESDIS on the value of earthaccess, and the desire to not disrupt the existing community development and engagement. An outcome of this meeting was to pursue a cross-DAAC proposal for sustained ESDIS funding, retaining the existing community ownership model while enhancing the communication of feature development across the earthaccess community and ESDIS. While inter-community support reduces ESDIS/NASA required support, we acknowledged in the proposal that increased ESDIS funding will also help us sustain the library. Although a proposal draft was developed, ESDIS asked for this effort to be paused in summer 2025. earthaccess is currently listed by ESDIS as an approved, operational Enterprise Solution, and was considered out of scope in broader tool and service convergence activities across other enterprise components. Regardless of the repository migration approach we choose, we will continue acknowledging ESDIS support through our ESDIS-funded contributors and the valuable facilitation role of NASA Openscapes. ### Migration effort tasks -Options 2 and 3 below would involve the movement of the existing earthaccess repository into another GitHub organization. - -Transferring a GitHub repository to another organization involves several impacts and considerations: -1. Repository URL and Local Clones: -The repository's URL will change to reflect the new organization. -GitHub provides redirects from the old URL, but it is recommended to update local clones to point to the new URL using git remote set-url origin NEW-URL to avoid potential issues and confusion. -2. Permissions and Access: -Permissions and access settings will need to be reconfigured within the new organization. -Team members who previously had access may need to be granted access to the repository within the new organization's structure. +Options 2 and 3 below would involve the movement of the existing earthaccess repository into another GitHub organization. + +This transfer would be transparent to the earthaccess community in the following ways: + +1. Repository URL (https://github.com/nsidc/earthaccess): + * While the repository's URL will change to reflect the new organization, GitHub provides redirects from the old URL. Users who bookmark the old URL should not be negatively impacted. +2. Readthedocs URL (https://earthaccess.readthedocs.io/en/stable/): + * This URL will not change even if the repository is migrated to a new GitHub organization. +3. Issues, Pull Requests, and Discussions: + * All existing issues, pull requests, and other project details (e.g., commit history, branches) will be transferred with the repository and remain intact. +4. Forks: + * According to GitHub [Transferring a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository#whats-transferred-with-a-repository) documentation, "If the transferred repository has any forks, then those forks will remain associated with the repository after the transfer is complete." + * In the above documentation, there is also mention of "Single repositories forked from a private upstream network cannot be transferred." but this may not apply to us(?). +5. PyPI and conda-forge releases: + * earthaccess publication to both PyPI and conda-forge package managers should continue as expected without any breaking changes. + +This transfer would lead to the following administrative changes: + +1. Local Clones: + * According to GitHub [Transferring a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository#whats-transferred-with-a-repository) documentation, "All links to the previous repository location are automatically redirected to the new location. When you use git clone, git fetch, or git push on a transferred repository, these commands will redirect to the new repository location or URL. However, to avoid confusion, we strongly recommend updating any existing local clones to point to the new repository URL. You can do this by using git remote on the command line: `git remote set-url origin NEW_URL` + * We may want to consider if/how to provide guidance to our community on this recommended update, though we expect this update would cause minimal disruption. +3. Permissions and Access to the new organization: + * earthaccess maintainers would need to consider updating/reconfiguring permissions and access settings for team members within the new organization. + * We may need to consider updates to our existing contributor documentation to reflect any applicable changes to our access processes. 3. Integrations and Third-Party Tools: -Any integrations or third-party tools connected to the repository (e.g., CI/CD pipelines, project management tools) may be affected. -These tools will likely need to be updated or reconfigured to work with the repository's new location and potentially different access tokens or settings. -4. Issues, Pull Requests, and Project Details: -All existing issues, pull requests, and other project details (e.g., commit history, branches) will be transferred with the repository and remain intact. -However, if you are using classic GitHub Projects tied to the repository, they will not transfer and references to issues/PRs within them may break. New GitHub Projects (beta) issues will remain but may need manual re-association. -5. GitHub Pages: -Links to the Git repository on the web and through Git activity will be redirected if the repository contains a GitHub Pages site. -However, the GitHub Pages site itself is not automatically redirected and may need manual adjustment or recreation in the new organization's context. -6. Forks: -If the repository was forked from a private upstream network, it cannot be transferred. -If the target organization already has a fork of the repository, the transfer cannot proceed. -7. Packages: -Packages associated with the repository may or may not transfer or retain their link, depending on the registry they belong to. Permissions for GitHub Packages should be reviewed. -8. Notifications: -Users who previously interacted with the repository will receive a notification that the repository has been moved. - -What are the things that don't need to be migrated - -Issues, PRs, etc. + * This may not apply to earthaccess, but we ought to consider whether any existing integrations in the NSIDC GitHub organization apply and would need to be re-connected to the migrated repository. +4. GitHub Project configuration + * Classic GitHub Projects tied to the repository will not transfer and references to issues/PRs within them may break. We need to identify whether we are utilizing classic vs new (beta) projects. For the latter option, project configuration may remain but may need manual re-association. + ## Considered Options @@ -86,6 +83,7 @@ Cons: ### Option 2: Move to an independent org, e.g. `earthaccess-dev`. Pros: +* Overall benefits described above * Full / flexible community governance * Custom branding? @@ -97,11 +95,13 @@ Cons: ### Option 3: Move to a sponsor / incubator org, e.g. `pangeo`, `openscapes`. Pros: +* Overall benefits described above * Built-in open source credibility and visibility * Leverage existing communities, increased contributor base? * Leverage existing software infrastructure?, * Leverage existing governance models? * Potential funding opportunities? + Cons: * Migration effort * Less control over organizationl decisions/policies/memership? @@ -111,7 +111,7 @@ Cons: ## Decision Outcome -? +TBD From b5cf123e3062e5724aaebc6d3c080a02a8046af1 Mon Sep 17 00:00:00 2001 From: Amy Steiker <47193922+asteiker@users.noreply.github.com> Date: Wed, 1 Oct 2025 09:20:45 -0600 Subject: [PATCH 3/5] Update docs/governance/decisions/929-move-repository.md Co-authored-by: Matt Fisher <3608264+mfisher87@users.noreply.github.com> --- docs/governance/decisions/929-move-repository.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/governance/decisions/929-move-repository.md b/docs/governance/decisions/929-move-repository.md index 950305be..1225b7a0 100644 --- a/docs/governance/decisions/929-move-repository.md +++ b/docs/governance/decisions/929-move-repository.md @@ -2,7 +2,7 @@ - Status: Ready for Review - Deciders: @jhkennedy, @chuckwondo, @mfisher87, @Sherwin-14, @asteiker, @itcarroll, @danielfromearth -- Date: 2025-07-08; modified 2025-09-30 +- Last updated: 2025-09-30 Technical Story: [#929 Move or fork to independent organization](https://github.com/nsidc/earthaccess/issues/929) From f59a7e0fc3869922e1429d189fd76ae603a52026 Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Wed, 1 Oct 2025 17:02:37 +0000 Subject: [PATCH 4/5] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- docs/governance/decisions/929-move-repository.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/governance/decisions/929-move-repository.md b/docs/governance/decisions/929-move-repository.md index 1225b7a0..ab76f16a 100644 --- a/docs/governance/decisions/929-move-repository.md +++ b/docs/governance/decisions/929-move-repository.md @@ -29,18 +29,18 @@ In order to strengthen the community engagement of earthaccess and lower partici ### Historical Context -A presentation by several earthaccess maintainers to NASA ESDIS on 11 February 2025 provided additional context and benefits of "repotting" the earthaccess repository, in order to learn more about their stance on moving and how this might impact future funding opportunities. This presentation highlighted other key benefits of repotting the repository, including: +A presentation by several earthaccess maintainers to NASA ESDIS on 11 February 2025 provided additional context and benefits of "repotting" the earthaccess repository, in order to learn more about their stance on moving and how this might impact future funding opportunities. This presentation highlighted other key benefits of repotting the repository, including: * Accelerating development via broader participation. * Lowering the cost:value even further for NASA ESDIS by enabling rapid innovation and improved security through rapid bug fixes. * Promoting NASA’s partnerships with other community members based on shared goals, by actively recognizing the critical contributions of those members and increasing transparency and trust. * Meeting NASA Open Source Science goals. -Subsequent discussion included positive feedback from ESDIS on the value of earthaccess, and the desire to not disrupt the existing community development and engagement. An outcome of this meeting was to pursue a cross-DAAC proposal for sustained ESDIS funding, retaining the existing community ownership model while enhancing the communication of feature development across the earthaccess community and ESDIS. While inter-community support reduces ESDIS/NASA required support, we acknowledged in the proposal that increased ESDIS funding will also help us sustain the library. Although a proposal draft was developed, ESDIS asked for this effort to be paused in summer 2025. earthaccess is currently listed by ESDIS as an approved, operational Enterprise Solution, and was considered out of scope in broader tool and service convergence activities across other enterprise components. Regardless of the repository migration approach we choose, we will continue acknowledging ESDIS support through our ESDIS-funded contributors and the valuable facilitation role of NASA Openscapes. +Subsequent discussion included positive feedback from ESDIS on the value of earthaccess, and the desire to not disrupt the existing community development and engagement. An outcome of this meeting was to pursue a cross-DAAC proposal for sustained ESDIS funding, retaining the existing community ownership model while enhancing the communication of feature development across the earthaccess community and ESDIS. While inter-community support reduces ESDIS/NASA required support, we acknowledged in the proposal that increased ESDIS funding will also help us sustain the library. Although a proposal draft was developed, ESDIS asked for this effort to be paused in summer 2025. earthaccess is currently listed by ESDIS as an approved, operational Enterprise Solution, and was considered out of scope in broader tool and service convergence activities across other enterprise components. Regardless of the repository migration approach we choose, we will continue acknowledging ESDIS support through our ESDIS-funded contributors and the valuable facilitation role of NASA Openscapes. ### Migration effort tasks -Options 2 and 3 below would involve the movement of the existing earthaccess repository into another GitHub organization. +Options 2 and 3 below would involve the movement of the existing earthaccess repository into another GitHub organization. This transfer would be transparent to the earthaccess community in the following ways: @@ -57,7 +57,7 @@ This transfer would be transparent to the earthaccess community in the following * earthaccess publication to both PyPI and conda-forge package managers should continue as expected without any breaking changes. This transfer would lead to the following administrative changes: - + 1. Local Clones: * According to GitHub [Transferring a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository#whats-transferred-with-a-repository) documentation, "All links to the previous repository location are automatically redirected to the new location. When you use git clone, git fetch, or git push on a transferred repository, these commands will redirect to the new repository location or URL. However, to avoid confusion, we strongly recommend updating any existing local clones to point to the new repository URL. You can do this by using git remote on the command line: `git remote set-url origin NEW_URL` * We may want to consider if/how to provide guidance to our community on this recommended update, though we expect this update would cause minimal disruption. @@ -65,9 +65,9 @@ This transfer would lead to the following administrative changes: * earthaccess maintainers would need to consider updating/reconfiguring permissions and access settings for team members within the new organization. * We may need to consider updates to our existing contributor documentation to reflect any applicable changes to our access processes. 3. Integrations and Third-Party Tools: - * This may not apply to earthaccess, but we ought to consider whether any existing integrations in the NSIDC GitHub organization apply and would need to be re-connected to the migrated repository. + * This may not apply to earthaccess, but we ought to consider whether any existing integrations in the NSIDC GitHub organization apply and would need to be re-connected to the migrated repository. 4. GitHub Project configuration - * Classic GitHub Projects tied to the repository will not transfer and references to issues/PRs within them may break. We need to identify whether we are utilizing classic vs new (beta) projects. For the latter option, project configuration may remain but may need manual re-association. + * Classic GitHub Projects tied to the repository will not transfer and references to issues/PRs within them may break. We need to identify whether we are utilizing classic vs new (beta) projects. For the latter option, project configuration may remain but may need manual re-association. ## Considered Options @@ -112,6 +112,3 @@ Cons: ## Decision Outcome TBD - - - From 5ef7d54444275bdebe5e5425cd80ad73806475b9 Mon Sep 17 00:00:00 2001 From: Matt Fisher <3608264+mfisher87@users.noreply.github.com> Date: Wed, 1 Oct 2025 11:04:48 -0600 Subject: [PATCH 5/5] Typo fixes --- docs/governance/decisions/929-move-repository.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/governance/decisions/929-move-repository.md b/docs/governance/decisions/929-move-repository.md index ab76f16a..74e2383a 100644 --- a/docs/governance/decisions/929-move-repository.md +++ b/docs/governance/decisions/929-move-repository.md @@ -104,7 +104,7 @@ Pros: Cons: * Migration effort -* Less control over organizationl decisions/policies/memership? +* Less control over organizational decisions/policies/membership? * May need to align with existing organization's priorities and processes