Skip to content
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

add deprecate guidelines doc [draft] #150

Merged
merged 22 commits into from Jun 5, 2019
Merged

add deprecate guidelines doc [draft] #150

merged 22 commits into from Jun 5, 2019

Conversation

@jchip
Copy link
Contributor

@jchip jchip commented Feb 5, 2019

No description provided.

docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
@mhdawson
Copy link
Member

@mhdawson mhdawson commented Feb 22, 2019

I think this might be mixing different concerns. What should a consumer do and what might this team do. Would it make sense to break it out into those 2 sections or possibly 2 doc?

@jchip jchip requested review from ljharb, mhdawson and Eomm Mar 7, 2019
@jchip
Copy link
Contributor Author

@jchip jchip commented Mar 7, 2019

I made some changes with target audience in mind. Please re-review.


## `npm deprecate` command
Once you've identified a package may be unmaintained, please open an issue for the Node.js package-maintenance working group to check and identify path forward.

This comment has been minimized.

@dominykas

dominykas Mar 7, 2019
Member

Is this the right recommendation? I would like to see package-maintenance group to be the last resort (depending on popularity of the package, of course), but I would generally recommend looking for alternatives (are there any tools out there?) and then forking, i.e. dyi?

This comment has been minimized.

@ljharb

ljharb Mar 7, 2019
Member

Forking is an important ability, but I see that as more of a last resort than asking this group - creating forks further fractures the ecosystem, and doesn't help all of the users who are still using the unmaintained version unwittingly.

This comment has been minimized.

@jchip

jchip Mar 11, 2019
Author Contributor

if no one can reach the author then there's really not much anyone could do. I was thinking that the best this group could do is get npm ownership and actively advertise for someone interested in becoming the maintainer, and/or add deprecate message to identify alternative if one exist.

docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved

## `npm deprecate` command
Once you've identified a package may be unmaintained, please open an issue for the Node.js package-maintenance working group to check and identify path forward.

This comment has been minimized.

@ljharb

ljharb Mar 7, 2019
Member

Forking is an important ability, but I see that as more of a last resort than asking this group - creating forks further fractures the ecosystem, and doesn't help all of the users who are still using the unmaintained version unwittingly.

docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
ljharb and others added 8 commits Mar 11, 2019
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
Co-Authored-By: jchip <jchip@users.noreply.github.com>
@rxmarbles rxmarbles added this to In progress in Package Maintenance Roadmap Mar 20, 2019
@mcollina
Copy link
Member

@mcollina mcollina commented May 20, 2019

@jchip are you still interested in getting this PR landed? Otherwise, is there anybody else that would like to help in moving this forward?

@craftninja
Copy link
Contributor

@craftninja craftninja commented May 20, 2019

@jchip I'd be glad to take this over if you don't have time, no pressure!

@jchip
Copy link
Contributor Author

@jchip jchip commented May 21, 2019

@mcollina I addressed the review comments in my last commit and I don't see any further comments. I was hoping for enough approves to move this to be considered for merging.

@craftninja Thanks for the offer. I'd like to see if there're anymore comments and see if this PR can get enough approves to be considered merging. I generally have problem attending every other meeting due to me being in PST, but will see if I can get this discussed and merge in next meeting.

@jchip jchip requested review from dominykas and ljharb May 23, 2019
Package Maintenance Roadmap automation moved this from Reviewer approved to Review in progress May 23, 2019
Copy link
Member

@ljharb ljharb left a comment

I still have a large number of open suggestions; I’ve commented on a few.

docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
docs/drafts/DEPRECATE-GUIDELINES.md Outdated Show resolved Hide resolved
jchip and others added 7 commits May 24, 2019
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
Co-Authored-By: Jordan Harband <ljharb@gmail.com>
@jchip
Copy link
Contributor Author

@jchip jchip commented May 24, 2019

@ljharb thanks, going through them again.

On a side note, I miss them partly due to github has this curious way of reseting the page to the top after you commit each suggested changes, and then you have to scroll down, expand comments, and find back to where you were. Is that just me? Is there a better way?

Co-Authored-By: Jordan Harband <ljharb@gmail.com>
@jchip
Copy link
Contributor Author

@jchip jchip commented May 24, 2019

@ljharb that should be all of them. Please review. Thanks.

@Eomm
Copy link
Member

@Eomm Eomm commented Jun 3, 2019

Only for note.

In a following PR, I think it could be worth adding some node args like --throw-deprecation

Package Maintenance Roadmap automation moved this from Review in progress to Reviewer approved Jun 3, 2019
@ljharb
ljharb approved these changes Jun 3, 2019
Copy link
Member

@dominykas dominykas left a comment

Nice

Copy link
Member

@mhdawson mhdawson left a comment

LGTM

@mhdawson
Copy link
Member

@mhdawson mhdawson commented Jun 5, 2019

Looks like this is ready to land.

@mhdawson mhdawson merged commit 293b0ab into nodejs:master Jun 5, 2019
Package Maintenance Roadmap automation moved this from Reviewer approved to Done Jun 5, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Linked issues

Successfully merging this pull request may close these issues.

None yet

8 participants
You can’t perform that action at this time.