New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Maintenance & Governance of standard #1948
Comments
A mob consisting of @rostislav-simonik , @jay-bulk and I are trying to adopt this project. We are working on it four hours weekly. I say trying because we haven't yet received npm publish permission for anything other than eslint-config-standard-with-typescript. Would you be interested in hopping in during one of our sessions? Schedule here: |
The mob programming model does not really work for the rest of us. I don't think I would be able to join your mob call anytime soon. |
Sorry—just to clarify—the rest of us whom, please? |
Sure. I'll do what I can. |
Currently, no one is doing releases for this project, and it has essentially stalled. @voxpelli has been doing releases for the last 2 years, and this initiative has its blessing as well. Ultimately, I would prefer to move this forward vs forking, but forking is 100% an option. cc @wesleytodd |
@mcollina I'm the newest "member" to join the mob group. I'd be happy to hop on a call and fill in the gaps if the rest of the team is unable. |
Sorry. Of course I'll be happy to join whatever call you're organizing. I'm also sorry that our mob did not receive @feross' trust by now and that this is happening instead. @feross did, however, let us know that he will look into our past contributions during December in order to assess his faith in us. |
For context, eslint-config-standard-with-typescript, the package I've authored and have been maintaining for several years and more recently with the help of @rostislav-simonik and @jay-bulk in our mob seems at a level of popularity similar to the standard package. For more context, here is a message I wrote earlier on Discord. And a copy-paste here:
We couldn't get far on any package other than eslint-config-standard-with-typescript due to lack of npm publish permissions on them. We are three capable developers who've for the past few months have been blocked from maintaining this package set by lack of faith. And now someone else who seems to have won @feross faith is tasked to organize governance. This doesn't make me feel wanted. |
Based on this issue it sounds like official governance to maintain commit/publish access would be very helpful. Even the best individual maintainers cannot keep juggling everything, and the "lack of faith" problem is more about not having a governance model in place for building that trust. Really happy to help out here, especially knowing there are people who want to do the work. |
I'm +1 on @mcollina here, but I guess you know my point of view on this @mightyiam |
First task of your group @mightyiam should be to at least get Before that's done there's nothing showing that you are aware of or in line with the philosophy of this project |
@voxpelli that was aggressive. |
I'm not sure I have npm publish permission for that package. |
The issue of maintenance & governance of Standard definitely makes sense, as the maintenance/development is quite inactive outside of Standard need maintainers volunteers, there are already @mightyiam showing his interest and others. Now... Not everyone agrees, and I can understand that giving npm publish permission to someone is risky and the decision should be taken carefully. Maybe, the current maintainers having the npm permissions, could at least review the PRs and release new versions when needed, building the trust in collaboration with the ones submitting the PRs. We might also define the list of TODOs and the goals of Standard moving forward, what I see already are the following issues:
And probably lot more TODOs... |
Some example governence docs for reference:
I think it is important to scale the governence process to the project scope. I don't think something as complicated as Node's is needed here, but also express's is a bit lacking imo. I really like the way fastify structures this, and I think a few key things need to be established:
If having a sustainable model is the goal, we need some more generic governance practices before really digging into the list of todos imo. Not that it should stop folks from working on those, but to keep things going smoothly with a large group there needs to be some small structure around the goals and decision making. |
Hello, All topics mentioned here are essential, but I suggest not deviating too much. The most pressing issue now is to unblock those willing to spend time on this project because the most precious thing they offer is their time. I understand that new people could have different objectives, and original maintainers are cautious that we won't deviate from the original purpose of this project. To mitigate this risk, let's try to capture goals and principles a little bit better. So, each contributor can follow them, and PR reviews would become a formality rather than a necessity. During work on eslint-config-standard-with-typescript, we were following a few rules.
But there were a few cases where we had the dilemma of what would be the option, not violating upstream concept principles. So if @feross and the other original maintainers could spend one hour or two to capture those principles into some standard bible, it would make our decision-making much easier. And then who would have lead decisions or who will own the npm access tokens, would be the least concern. |
I'd be also interested in maintaining Standard. |
I vote for forks, and then if any of them become a clear successor, feross can consider re-merging. My sense is that conflicting interests/priorities have developed over time and are a major factor in lack of maintenance. I'm also open to an open governance approach, but it also depends on what that turns into. Generally my priorities would be:
|
I agree on those priorities I think, but I am not sure why forking is better. Forking means many people need to make changes across hundreds of repos. I have not followed all the convos here, so I can probably brush up on what has been going on, but is there an example of something that is an incompatible opinion among contributors in this ecosystem? |
Like this one But I was always wondering why both couldn't live. What prevents having a formatless config and then another that lives above that? |
Yeah, these are the kinds of topics you have a TC and governance doc to help guide a decision for. Ideally that governance group represents the diverse opinions of the users of the project, but even if not should strive to resolve the discussion in a way that keeps it healthy. Nothing in that topic (although controversial) seems like something impossible to reconcile. It seems like right now the problem is not even agreeing on a direction but shipping anything. So maybe we unlock the ability to make small uncontroversial changes now and then make the second agenda item listing and deciding on a direction for those more contravertial changes? |
If you used a GitHub action with required reviewers to publish, could that help unblock progress? |
Problem is lack of governance not lack of publishing |
@mcollina, so what are the next steps? When do you plan to throw a meeting? Can we please pencil the agenda for that call? Do we have some expectations of what we should prepare before the call? If I could provide my requirements ahead of time, then those would be mostly related to typescript ecosystem and automated CI
|
I would push us to have a discussion that is not that in the weeds initially. All of those topics are pretty in the weeds and getting governance in place is more high level. So the meeting should discuss project leadership, decision making guidance, how to manage access and publish rights, etc. And then all those points can be for later discussions or async in issues. |
Yes, I agree. I listed them mostly to understand which group I belong to. Ideally, it would be best if the governance model would incorporate rules for effectively transferring responsibilities from concerning people who become busy with something else. Or effective substitution, Because that's what is/was the current issue. Not the lack of interest to maintain/govern, but not having enough time to onboard new group. |
By the way, from CONTRIBUTING:
|
Would love to hear back from some of the instigators here. This is exactly what got us here in the first place. I'm willing to continue supporting standard, but being roadblocked isn't helping. I definitely have the least amount of experience in the room, but I'm here and I'm willing so I'd love some feedback here or correction if necessary. @mcollina I take @feross comments to mean he trusts you to help us steer the ship forward. Please suggest a time for us to meet and discuss moving forward. That being said, from the existing contribution guide as mentioned by @mightyiam the original intent may have devolved and may not be the best model moving forawrd. Regardless, if we want to proceed with a OpenJS-like governance model here's a draft PR. Hopefully this will get the ball rolling. I don't care what model we pick moving forward, but I am disappointed at how hard it's getting to get the red tape to clear. As I understand it the idea behind standard is to follow best practice and where one is not offered pick a standard and move forward. Ironic that we're struggling to come up with a standard on our own for managing the project and thus are stopping it from moving forward. @mcollina @voxpelli @wesleytodd @jsumners @theoludwig @bcomnes @anonrig please feel free to strike me down on this or add constructive feedback. I just want to get this moving again. |
My understanding is that it's working as expected. Apparently what's being landed does not meet the criteria/trust of the releasers. Therefore, nothing is getting shipped and the project is locked. My read of the current situation is that the "mob programming" model is a 100% culture clash with how @feross, @voxpelli, myself and all "old" folks develop OSS. We work asynchronously via PRs, while you all develop together synchronously. This is not fixable without a different governance. As I said a few times, my overall intent is to unblock standard, because I use this linter and I do not want to fork. Thanks for putting the PR in. I'm strapped for time until this Wednesday, then I'll make some progress on things (I have a backlog of 250+ gh notifications to process, I've been traveling for a while). |
Sorry. I never knew. Can this be confirmed, please? |
The quoted contributing blurb above is boilerplate adapted from "open open source" contributing guidelines, an attempt at loose "wiki" style open governance standards from over a decade ago when the node open source community was much, much smaller and conventions were more easily shared at the community level. Some readers might remember those times :) The purpose of the standard project was to prevent bike-shedding, avoiding arguments over style and linting and just enforcing something that worked, and for a long while it did work. The style enforced was prevalent among some (but not all) prominent open source node writers at the time standard was created (8 years ago!), and worked primarily for commonJS node written for the server or transformed for the browser with browserify. The scope of the project has of course grown to encompass a much wider set of use cases since then, and it's been widely adopted across the industry. However, standards and requirements between common, ESM, JSX, typescript, and friends have continued to diverge quite a bit over the years, and for all the worthy efforts of the standard team, keeping up with all flavors of node under one roof is beyond the scope of one loose and scrappy association of (unpaid) open source contributors. There is also the foundational problem of using eslint as a formatter, which has been written about at length elsewhere. The good people of this thread could endlessly bikeshed about the correct way to move forward, who is the true and trustworthy heir of the releasers, the proper way to manage the project going forward... but I would humbly suggest something else. When a project this big has stalled for a long time, and there are so many different voices wanting to do different things, sometimes the best thing to do is retire the project and start fresh. If you really want to keep standard going as-is, I recommend a fork. If you have a fresh perspective on solving linting and formatting with a standard-like approach for the current state of the open source JS ecosystem, I suggest creating something new. If you want to try to commandeer an enormous linting project that's been in maintenance mode for some time, by all means, continue! But at this age, scale, and velocity, discussion threads like these are often where ideas and good intentions go to die. I share this as someone who was an early supporter and member of the project, wishing you all the best of luck. That said, I'll be bowing out and removing myself from the project. Happy coding ✌️ |
@ungoldman thanks for your solid contributions, hopefully we can do your legacy (and so many others) justice. Best wishes. @mcollina totally understandable with your time constraints, I for one am grateful for your travels because I'm learning from your talks 😄 (NodeconfEU was awesome BTW, great job). I just want to make sure we don't lose momentum here so we can start publishing again until a long-term solution can be agreed upon. For that matter, I also prefer the asynchronous PR approach. Working mob on this project has been a new and informative experience. However we decide to move forward, I'm here to help. |
From the viewpoint of a user, asynchronous PRs are highly favorable as it allows for visibility of the roadmap and easy participation, without having to commit fully to mob sessions. Currently we are regularly surprised by a large number of breaking changes - almost every release of eslint-config-standard-with-typescript is semver-major. There are even some oversights (mightyiam/eslint-config-love#1230) bound to happen this way. I feel like the Node.js governance and development model has much more opportunity for users to become involved and prepare for changes, as well as preventing surprises. A wiki-like approach to software development seems highly dangerous and I would not want to use dependencies released in this way, from both a security and reliability standpoint, at least without version pinning and manual vetting of all code. |
eslint-config-standard-with-typescript is at major version 40. How are major version bumps surprising? For the record, I'm not certain that mightyiam/eslint-config-love#1244 included an oversight. eslint-config-standard-with-typescript is in constant increase in popularity, thanks to the work of myself, @rostislav-simonik and more recently @jay-bulk. Let's take a look at some statistics. Observations:
Despite the popularity of eslint-config-standard-with-typescript, it enjoys a marginal issue reporting rate. Many of the issues reported are misunderstandings. My impression is that users are satisfied. I suppose it's because we've been doing excellent work. We are the only regular contributors to this organization. If you care about the thousands of users of these packages, grant us npm publish access while we continue to discuss governance. |
I understand
Given I'm one of |
Maintaining an open source project does not require npm publish access. Maintaining an open source project means answering to all the issue tickets, reviewing all the pull requests, and creating new pull requests if a feature is frequently requested, but nobody else is up to do so. That's the bulk of the work, and it does not require any governance changes, and any permissions whatsoever. Here's a hundred open issues with zero answers and nobody available to sort them out. If you care about the thousand of users of these packages, you can start right there: |
I've been a part of Standard for a very long time, and from my feelings the goal of the project have always been to align itself with what people are already using, and only introduce breaking change when we can see that the absolute majority of all projects using standard are already compliant. That's why a lot of my work have been contributing fixes to other projects ahead of us adding new lint rules, and creating ecosystem analysis reports when we are thinking about adding a new rule. With the recent development in I think that this can be seen in the wider ecosystem by looking at the number of downloads for the different versions, e.g. from last week:
ref: https://www.npmjs.com/package/eslint-config-standard-with-typescript?activeTab=versions That's a lot of people using old (in terms of number of major versions behind latest) versions... Compared to
ref: https://www.npmjs.com/package/eslint-config-standard?activeTab=versions Personally, I would love for the regular Standard to also handle TypeScript, and for it to continue on a slow path forward where new rules are only added after we have verified that the ecosystem already is compliant. I also have a lot of open source repositories that uses Standard, so I would really not like to see many major releases which requires manual updates. I would be happy to stay on as a maintainer of Standard, if it continues with the philosophy that it has had before, which I described in my first paragraphs here. Finally, I would like to offer my apologies to @mightyiam & @rostislav-simonik. I've seen that you have tried to reach out to me on Discord. Since I only use that when I game or socialize with my friends, it has never been a good time to write out my thoughts clearly when I've seen it. But I felt that the direction that you have taken with the TypeScript standard hasn't been aligned with the philosophy of Standard, and thus I didn't want to give you publish access without this being discussed first. I'm sorry that I didn't initiate this discussion earlier, but I'm happy that it's taking place now! |
Thank you, @LinusU. There's no problem with frequent introduction of generally desirable rules. Users can upgrade at their own pace. Perhaps I should take eslint-config-standard-with-typescript somewhere else and rebrand it. |
@mightyiam This has been my proposal all along but your response has been that without the I think this would be the ideal solution. Moving I could for sure help out facilitate the moving of repositories and modules to such a new organization of yours. This I think would make you and your collaborators and users the happiest and eg me the happiest 😌 |
Just to clarify, I'm not saying that one approach is better than the other, and I think that it's great that you have been putting work into something that I hope is enjoyed by people! ❤️ I'm just saying that it's not a great fit for me personally, the way I'm using Standard. |
No worries, it's ok. Guys, the conversation got heated somehow, meantime 😉 . Everybody has good intentions here. It's just that nobody has a crystal ball, so some incompatible decisions were assumed in good faith. That's why I asked to capture the original maintainers' expectations because that info would make it all easier. @voxpelli @mcollina I understand now that the standard ecosystem expects less drastic changes. That's reasonable. On sessions with @mightyiam, we chose to do breaking changes more often but with a more minor impact. That comes of course, with not receiving patches or minor updates without mandatory modifications. Both approaches are viable, but each must be consistent with their users. And we unintentionally mixed them. So If some changes are incompatible with the standard users, let's revert. If there is still a will, Let's capture some rules and expectations, and if we agree on them, we can continue. If not, then we separate. There are no wrong options, just options. @mcollina @voxpelli, is there still an option on the table to have that call where each group can present their own expectations to find out if there is an intersection? |
Please see #1957. |
I have been in contact with @feross and I'm making progress on this - not much to update on yet. |
@mcollina it's been almost two months since the last update. I've tried reaching out to you and @feross via twitter to offer assistance. Do you have an estimated time line on when you think we'll start to see progress here? Sorry, I'm not trying to be a nuisance. You and Feross are both juggling running companies and multiple libraries which is very respectable. I've got projects that would like to see continued maintenance on this repo. However this thread is getting a little long in the tooth. For reference, I reached out to Feross on the issue of maintenance back in September. I want to be helpful but I'm also feeling slightly hand tied without permissions/governance in place. |
@jay-bulk We’re still actively working on this |
I've not been able to reach to feross to discuss this any further. |
@mcollina Hey there. So.. I am up for this as well and use ts-standard, in all my projects including the ones for fastify plugins. So let me know! |
After a long twitter thread and looking at the contribution graphs, it seems that to keep supporting Standard users, we need to come up with some new governance.
I maintain hundreds of packages relying on standard, Including the whole Fastify organization (discussion link fastify/fastify#5159). It seems simpler to help maintaining this than moving all of those to a different formatter / linter.
@feross said he would trust me to help with governance and kickstart the work again.
Should we schedule a quick call?
@standard/team @voxpelli @jsumners
The text was updated successfully, but these errors were encountered: