docs: 'How ESLint is Maintained' page #16961

bpmutter · 2023-03-05T21:33:24Z

Prerequisites checklist

I have read the contributing guidelines.

What is the purpose of this pull request? (put an "X" next to an item)

[x] Documentation update
[ ] Bug fix (template)
[ ] New rule (template)
[ ] Changes an existing rule (template)
[ ] Add autofix to a rule
[ ] Add a CLI option
[ ] Add something to the core
[ ] Other, please explain:

What changes did you make? (Give an overview)

Is there anything you'd like reviewers to focus on?

Resolves #16941

netlify · 2023-03-05T21:33:30Z

✅ Deploy Preview for docs-eslint ready!

Name	Link
🔨 Latest commit	`820b2cf`
🔍 Latest deploy log	https://app.netlify.com/sites/docs-eslint/deploys/6411908cd8e80c00080d186e
😎 Deploy Preview	https://deploy-preview-16961--docs-eslint.netlify.app/maintain/overview
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

bpmutter · 2023-03-05T21:34:24Z

@nzakas could you take a look at this page, including:

responding to the TODOs with comments
giving the page a quick once-over and letting me know if there's any other content/sections you'd like to improve.

snitin315 · 2023-03-06T01:50:35Z

docs/src/maintain/overview.md

+
+## Joining the Maintainer Team
+
+ESLint is an open-source project, and anyone can contribute to the project. If you're interested in becoming part of the maintainer team, TODO: what to do?


This info is actually covered in the governance doc

I think we can probably say "Stop by Discord and introduce yourself" as an easier way to get people started.

nzakas · 2023-03-06T21:19:10Z

docs/src/maintain/index.md

@@ -9,6 +9,10 @@ eleventyNavigation:

 This guide is intended for those who work as part of the ESLint project team.

+## [How ESLint is Maintained](overview)
+
+Explains how ESLint is maintained, including information about team, governance, and funding.


Governance is still under Contribute right now, do we want to move it as part of this PR?

let's keep it there. i remember when we were doing the IA updates, there was some discussion on the matter, and we decided at the time to keep governance in Contribute.

nzakas · 2023-03-06T21:23:49Z

docs/src/maintain/overview.md

+
+## Organization Structure
+
+TODO: provide a little more info about what the OpenJS foundation actually does vis-a-vis ESLint.


I'm not sure if we'd want to use this verbatim, but here's an overview. You can pick and choose from this:

The OpenJS Foundation provides the legal infrastructure for JavaScript projects like ESLint. It is the owner of the intellectual property related to ESLint, including copyrights and trademarks, and ensures the independence of the project.

While the OpenJS Foundation does not participate in the day-to-day functioning of the project, they are a resource for ESLint should we need legal advice or representation.

thx, this is perfect. adapting into the answer.

eslint-github-bot · 2023-03-10T02:19:33Z

Hi @bpmutter!, thanks for the Pull Request

The pull request title isn't properly formatted. We ask that you update the message to match this format, as we use it to generate changelogs and automate releases.

The commit message tag wasn't recognized. Did you mean "docs", "fix", or "feat"?
There should be a space following the initial tag and colon, for example 'feat: Message'.
The first letter of the tag should be in lowercase

To Fix: You can fix this problem by clicking 'Edit' next to the pull request title at the top of this page.

Read more about contributing to ESLint here

eslint-github-bot · 2023-03-10T02:23:51Z

Hi @bpmutter!, thanks for the Pull Request

The pull request title isn't properly formatted. We ask that you update the message to match this format, as we use it to generate changelogs and automate releases.

The commit message tag wasn't recognized. Did you mean "docs", "fix", or "feat"?
There should be a space following the initial tag and colon, for example 'feat: Message'.
The first letter of the tag should be in lowercase

To Fix: You can fix this problem by clicking 'Edit' next to the pull request title at the top of this page.

Read more about contributing to ESLint here

eslint-github-bot · 2023-03-10T02:26:17Z

Hi @bpmutter!, thanks for the Pull Request

The pull request title isn't properly formatted. We ask that you update the message to match this format, as we use it to generate changelogs and automate releases.

The commit message tag wasn't recognized. Did you mean "docs", "fix", or "feat"?
There should be a space following the initial tag and colon, for example 'feat: Message'.
The first letter of the tag should be in lowercase

To Fix: You can fix this problem by clicking 'Edit' next to the pull request title at the top of this page.

Read more about contributing to ESLint here

docs/src/maintain/overview.md

nzakas

This is looking really good. Just left a couple minor suggestions but otherwise I think this is good to go.

nzakas · 2023-03-10T20:46:43Z

Would like @mdjermanovic to review before merging.

snitin315

LGTM. Left a few minor suggestions.

docs/src/maintain/overview.md

harish-sethuraman · 2023-03-11T05:09:18Z

docs/src/maintain/overview.md

+
+## The ESLint Team
+
+The ESLint team work together to develop and maintain ESLint. To learn more about the different roles on the ESLint team, refer to [Governance](../contribute/governance). To see the current team members, refer to [Team](https://eslint.org/team/).


I'd prefer teams page to be redirected to the actual host it is running on instead of always redirecting to eslint.org site. WDYT?

Suggested change

The ESLint team work together to develop and maintain ESLint. To learn more about the different roles on the ESLint team, refer to [Governance](../contribute/governance). To see the current team members, refer to [Team](https://eslint.org/team/).

The ESLint team work together to develop and maintain ESLint. To learn more about the different roles on the ESLint team, refer to [Governance](../contribute/governance). To see the current team members, refer to [Team](/team).

is this what you mean?

Co-authored-by: Nitin Kumar <snitin315@gmail.com> Co-authored-by: Nicholas C. Zakas <nicholas@humanwhocodes.com>

docs/src/maintain/overview.md

Co-authored-by: Milos Djermanovic <milos.djermanovic@gmail.com>

docs/src/maintain/overview.md

Co-authored-by: Ben Perlmutter <57849986+bpmutter@users.noreply.github.com>

mdjermanovic

LGTM, thanks!

This PR contains the following updates: | Package | Type | Update | Change | |---|---|---|---| | [eslint](https://eslint.org) ([source](https://github.com/eslint/eslint)) | devDependencies | minor | [`8.36.0` -> `8.37.0`](https://renovatebot.com/diffs/npm/eslint/8.36.0/8.37.0) | --- ### Release Notes <details> <summary>eslint/eslint</summary> ### [`v8.37.0`](https://github.com/eslint/eslint/releases/tag/v8.37.0) [Compare Source](eslint/eslint@v8.36.0...v8.37.0) #### Features - [`b6ab8b2`](eslint/eslint@b6ab8b2) feat: `require-unicode-regexp` add suggestions ([#17007](eslint/eslint#17007)) (Josh Goldberg) - [`10022b1`](eslint/eslint@10022b1) feat: Copy getScope() to SourceCode ([#17004](eslint/eslint#17004)) (Nicholas C. Zakas) - [`1665c02`](eslint/eslint@1665c02) feat: Use plugin metadata for flat config serialization ([#16992](eslint/eslint#16992)) (Nicholas C. Zakas) - [`b3634f6`](eslint/eslint@b3634f6) feat: docs license ([#17010](eslint/eslint#17010)) (Samuel Roldan) - [`892e6e5`](eslint/eslint@892e6e5) feat: languageOptions.parser must be an object. ([#16985](eslint/eslint#16985)) (Nicholas C. Zakas) #### Bug Fixes - [`619f3fd`](eslint/eslint@619f3fd) fix: correctly handle `null` default config in `RuleTester` ([#17023](eslint/eslint#17023)) (Brad Zacher) - [`1fbf118`](eslint/eslint@1fbf118) fix: `getFirstToken`/`getLastToken` on comment-only node ([#16889](eslint/eslint#16889)) (Francesco Trotta) - [`129e252`](eslint/eslint@129e252) fix: Fix typo in `logical-assignment-operators` rule description ([#17000](eslint/eslint#17000)) (Francesco Trotta) #### Documentation - [`75339df`](eslint/eslint@75339df) docs: fix typos and missing info in id-match docs ([#17029](eslint/eslint#17029)) (Ed Lucas) - [`ec2d830`](eslint/eslint@ec2d830) docs: Fix typos in the `semi` rule docs ([#17012](eslint/eslint#17012)) (Andrii Lundiak) - [`e39f28d`](eslint/eslint@e39f28d) docs: add back to top button ([#16979](eslint/eslint#16979)) (Tanuj Kanti) - [`721c717`](eslint/eslint@721c717) docs: Custom Processors cleanup and expansion ([#16838](eslint/eslint#16838)) (Ben Perlmutter) - [`d049f97`](eslint/eslint@d049f97) docs: 'How ESLint is Maintained' page ([#16961](eslint/eslint#16961)) (Ben Perlmutter) - [`5251a92`](eslint/eslint@5251a92) docs: Describe guard options for guard-for-in ([#16986](eslint/eslint#16986)) (alope107) - [`6157d81`](eslint/eslint@6157d81) docs: Add example to guard-for-in docs. ([#16983](eslint/eslint#16983)) (alope107) - [`fd47998`](eslint/eslint@fd47998) docs: update `Array.prototype.toSorted` specification link ([#16982](eslint/eslint#16982)) (Milos Djermanovic) - [`3e1cf6b`](eslint/eslint@3e1cf6b) docs: Copy edits on Maintain ESLint docs ([#16939](eslint/eslint#16939)) (Ben Perlmutter) #### Chores - [`c67f299`](eslint/eslint@c67f299) chore: upgrade [@eslint/js](https://github.com/eslint/js)[@8](https://github.com/8).37.0 ([#17033](eslint/eslint#17033)) (Milos Djermanovic) - [`ee9ddbd`](eslint/eslint@ee9ddbd) chore: package.json update for [@eslint/js](https://github.com/eslint/js) release (ESLint Jenkins) - [`dddb475`](eslint/eslint@dddb475) chore: upgrade [@eslint/eslintrc](https://github.com/eslint/eslintrc)[@2](https://github.com/2).0.2 ([#17032](eslint/eslint#17032)) (Milos Djermanovic) - [`522431e`](eslint/eslint@522431e) chore: upgrade espree@9.5.1 ([#17031](eslint/eslint#17031)) (Milos Djermanovic) - [`f5f9a88`](eslint/eslint@f5f9a88) chore: upgrade eslint-visitor-keys@3.4.0 ([#17030](eslint/eslint#17030)) (Milos Djermanovic) - [`4dd8d52`](eslint/eslint@4dd8d52) ci: bump actions/stale from 7 to 8 ([#17026](eslint/eslint#17026)) (dependabot\[bot]) - [`ad9dd6a`](eslint/eslint@ad9dd6a) chore: remove duplicate scss, ([#17005](eslint/eslint#17005)) (Strek) - [`ada6a3e`](eslint/eslint@ada6a3e) ci: unpin Node 19 ([#16993](eslint/eslint#16993)) (Milos Djermanovic) - [`c3da975`](eslint/eslint@c3da975) chore: Remove triage label from template ([#16990](eslint/eslint#16990)) (Nicholas C. Zakas) - [`69bc0e2`](eslint/eslint@69bc0e2) ci: pin Node 19 to 19.7.0 ([#16987](eslint/eslint#16987)) (Milos Djermanovic) </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).  Co-authored-by: cabr2-bot <cabr2.help@gmail.com> Reviewed-on: https://codeberg.org/Calciumdibromid/CaBr2/pulls/1834 Reviewed-by: Epsilon_02 <epsilon_02@noreply.codeberg.org> Co-authored-by: Calciumdibromid Bot <cabr2_bot@noreply.codeberg.org> Co-committed-by: Calciumdibromid Bot <cabr2_bot@noreply.codeberg.org>

docs: How eslint is maintained page

53eba9c

eslint-github-bot bot added triage An ESLint team member will look at this issue soon documentation Relates to ESLint's documentation labels Mar 5, 2023

snitin315 reviewed Mar 6, 2023

View reviewed changes

nzakas reviewed Mar 6, 2023

View reviewed changes

implement reviewer feedback

c0cdb70

remove trailing space

694fb67

remove todo

9ac0437

bpmutter changed the title ~~Docs: 'How ESLint is Maintained' page~~ docs: 'How ESLint is Maintained' page Mar 10, 2023

bpmutter marked this pull request as ready for review March 10, 2023 02:27

bpmutter requested a review from a team as a code owner March 10, 2023 02:27

nzakas reviewed Mar 10, 2023

View reviewed changes

docs/src/maintain/overview.md Outdated Show resolved Hide resolved

nzakas reviewed Mar 10, 2023

View reviewed changes

docs/src/maintain/overview.md Outdated Show resolved Hide resolved

nzakas approved these changes Mar 10, 2023

View reviewed changes

snitin315 approved these changes Mar 11, 2023

View reviewed changes

docs/src/maintain/overview.md Outdated Show resolved Hide resolved

docs/src/maintain/overview.md Show resolved Hide resolved

harish-sethuraman reviewed Mar 11, 2023

View reviewed changes

Apply suggestions from code review

3e86786

Co-authored-by: Nitin Kumar <snitin315@gmail.com> Co-authored-by: Nicholas C. Zakas <nicholas@humanwhocodes.com>

snitin315 added accepted There is consensus among the team that this change meets the criteria for inclusion and removed triage An ESLint team member will look at this issue soon labels Mar 12, 2023

mdjermanovic reviewed Mar 13, 2023

View reviewed changes

docs/src/maintain/overview.md Outdated Show resolved Hide resolved

Apply suggestions from code review

50cb55c

Co-authored-by: Milos Djermanovic <milos.djermanovic@gmail.com>

bpmutter commented Mar 14, 2023

View reviewed changes

docs/src/maintain/overview.md Outdated Show resolved Hide resolved

bpmutter requested a review from mdjermanovic March 14, 2023 23:37

Update docs/src/maintain/overview.md

820b2cf

Co-authored-by: Ben Perlmutter <57849986+bpmutter@users.noreply.github.com>

mdjermanovic approved these changes Mar 15, 2023

View reviewed changes

mdjermanovic merged commit d049f97 into eslint:main Mar 15, 2023
17 checks passed

github-actions bot mentioned this pull request May 2, 2023

Upgraded some dependencies - Attempt 2 AurorNZ/report-updated-dependencies#638

Merged

eslint-github-bot bot locked and limited conversation to collaborators Sep 12, 2023

eslint-github-bot bot added the archived due to age This issue has been archived; please open a new issue for any further discussion label Sep 12, 2023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs: 'How ESLint is Maintained' page #16961

docs: 'How ESLint is Maintained' page #16961

bpmutter commented Mar 5, 2023 •

edited

netlify bot commented Mar 5, 2023 •

edited

bpmutter commented Mar 5, 2023

snitin315 Mar 6, 2023

nzakas Mar 6, 2023

nzakas Mar 6, 2023

bpmutter Mar 10, 2023

nzakas Mar 6, 2023

bpmutter Mar 10, 2023

eslint-github-bot bot commented Mar 10, 2023

eslint-github-bot bot commented Mar 10, 2023

eslint-github-bot bot commented Mar 10, 2023

nzakas left a comment

nzakas commented Mar 10, 2023

snitin315 left a comment

harish-sethuraman Mar 11, 2023

bpmutter Mar 11, 2023

harish-sethuraman Mar 12, 2023

mdjermanovic left a comment


		## Joining the Maintainer Team

		ESLint is an open-source project, and anyone can contribute to the project. If you're interested in becoming part of the maintainer team, TODO: what to do?


		## Organization Structure

		TODO: provide a little more info about what the OpenJS foundation actually does vis-a-vis ESLint.


		## The ESLint Team

		The ESLint team work together to develop and maintain ESLint. To learn more about the different roles on the ESLint team, refer to [Governance](../contribute/governance). To see the current team members, refer to [Team](https://eslint.org/team/).

docs: 'How ESLint is Maintained' page #16961

docs: 'How ESLint is Maintained' page #16961

Conversation

bpmutter commented Mar 5, 2023 • edited

Prerequisites checklist

What is the purpose of this pull request? (put an "X" next to an item)

What changes did you make? (Give an overview)

Is there anything you'd like reviewers to focus on?

netlify bot commented Mar 5, 2023 • edited

✅ Deploy Preview for docs-eslint ready!

bpmutter commented Mar 5, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

eslint-github-bot bot commented Mar 10, 2023

eslint-github-bot bot commented Mar 10, 2023

eslint-github-bot bot commented Mar 10, 2023

nzakas left a comment

Choose a reason for hiding this comment

nzakas commented Mar 10, 2023

snitin315 left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mdjermanovic left a comment

Choose a reason for hiding this comment

bpmutter commented Mar 5, 2023 •

edited

netlify bot commented Mar 5, 2023 •

edited