Skip to content

Create site + new issue template - #17

Open
ianhi wants to merge 6 commits into
xarray-contrib:mainfrom
ianhi:ian/site
Open

ianhi wants to merge 6 commits into
xarray-contrib:mainfrom
ianhi:ian/site

Conversation

@ianhi

@ianhi ianhi commented Jul 24, 2025

Copy link
Copy Markdown

Follow up to #15

This creates a new static website with more information and makes a new issue template for requests to help maintain. This is modeled on https://jupyterlab-contrib.github.io/

A key change is that I added an explicit requirement to provide the "keys to castle" to any projects added here. So that if the original authors stop responding the xarray-contrib org has the power to allow access to anyone who wants to volunteer to work on the project. This should require some discussion the right way to transfer these permissions (e.g. should we have a pypi organization?)

@dcherian

Copy link
Copy Markdown

Let's discuss at the bi-weekly meeting next week

@keewis keewis left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've got some comments, but not necessarily answers

Comment thread .github/ISSUE_TEMPLATE/help-maintain.yaml Outdated
label: What do you want to do
options:
- label: Address reported issues and feature requests
- label: Update a **Archived** repository to make it work on the latest JupyterLab version

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should adapt this

Comment thread .github/ISSUE_TEMPLATE/help-maintain.yaml
Comment thread add-a-project.md Outdated

### 1. Open source license

The project must bee Licensed under an [OSI approved license](https://opensource.org/licenses)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The project must bee Licensed under an [OSI approved license](https://opensource.org/licenses)
The project must be Licensed under an [OSI approved license](https://opensource.org/licenses)

Comment thread add-a-project.md

**conda-forge**

If there is a conda-forge package then an xarray-contrib core team member must be added as an owner of the package (TODO: is there an easier way?)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think there's an easier way, but on conda-forge rights management is already much easier than on PyPI

Comment thread add-a-project.md Outdated

#### Documentation

Any documentation hosting (e.g. `readthedocs`) must also be shared with `xarray-contrib`

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how would we do that? If we ask for it, we should provide a suggestion.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

for now i m writing just adding someone. but i think having an xarray-contrib account on common platforms like readthedocs might also be helpful.

@ianhi

ianhi commented Aug 7, 2025

Copy link
Copy Markdown
Author

@shoyer after discussing with @keewis we think we would like to create a pypi organization to test out the concept of using that to maintain access to pypi publishing even if original maintainers drop off.

You are the natural person to apply for creating such an account (but can easily add other owners/managers later). Would you be willing to do the application process (https://docs.pypi.org/organization-accounts/actions/org-actions/#create-an-organization) for an xarray-contrib org so we can try it out to see if it is a good solution?

@keewis

keewis commented Aug 7, 2025

Copy link
Copy Markdown
Member

I think any of the owners of xarray-contrib should be able to request the organization account, we just need to have that info in the public. The information required and not immediately obvious is:

  • display name
  • organization url
  • description
  • membership size (I'd say this should be low, somewhere between 2-10)

@keewis

keewis commented Aug 12, 2025

Copy link
Copy Markdown
Member

what do you think about:

  • organization account name: xarray-contrib
  • organization display name: xarray contrib
  • organization url: https://github.com/xarray-contrib
  • organization description: collection of community packages with ensured maintenance by the xarray maintainer team
  • organization membership size: 6-10
  • anticipated usage: Management of the involved pypi projects in case of abandoned projects
  • organization type: community

Once we figured that out, one of us (ideally someone who is also a maintainer of the xarray project on PyPI) would request the organization.

@ianhi

ianhi commented Aug 12, 2025

Copy link
Copy Markdown
Author

That all seems good to me with the possible exception of

organization membership size: 6-10

I suspect if this is successful it will grow beyond that presuming anyone working on a specific package needs to become a member. but that's not a huge deal

one of us (ideally someone who is also a maintainer of the xarray project on PyPI) would request the organization.

Agreed.

@keewis

keewis commented Aug 12, 2025

Copy link
Copy Markdown
Member

organization membership size: 6-10

I guess this depends on the way organizations work, but I was thinking this was the number of people performing admin tasks in that organization (i.e. us who are supposed to transfer ownership in case maintainers stop responding).

Maybe that's not how organization model works (the form explicitly says "NOT the number of people in your organization"), so I'll have to investigate this further.

@shoyer

shoyer commented Aug 13, 2025

Copy link
Copy Markdown
Contributor

I filed the request on PyPI to make a new "xarray-contrib" organization. I'll add all of you as maintainers once it's approved!

@ianhi

ianhi commented Jan 28, 2026

Copy link
Copy Markdown
Author

a pypi org now exists! thank you @shoyer! given this does anyone have thoughts on codifying this policy?

@dcherian

Copy link
Copy Markdown

I like the policy and support starting with requiring it and adapting if needed when someone complains.

@ianhi

ianhi commented Jan 28, 2026

Copy link
Copy Markdown
Author

Ok i have updated the site to finish filliing out

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants