You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Official deprecation notice guidelines for deprecating a GH repository #1941
Also, you reference "Archiving the repo", but I'm not really clear on what you mean. As best I can tell, Github doesn't provide an archive feature: https://help.github.com/articles/can-i-archive-a-repository/ (although there does appear to be 3rd-party support for such functionality.)
Good ideas, will add them to the list in the first comment.
Also, you reference "Archiving the repo", but I'm not really clear on what you mean. As best I can tell, Github doesn't provide an archive feature: https://help.github.com/articles/can-i-archive-a-repository/ (although there does appear to be 3rd-party support for such functionality.)
The procedure here at StrongLoop is not to "delete" any repos. We just mark the as private and keep the code in case a need comes up later (like in your case I made the repo public again).
In my opinion, we should not hide (mark as private) any public repositories that are deprecated. It confuses users, especially since the npmjs.org website will still contain a link to the GitHub repository. It also makes it more difficult for community members to take over the project, as they cannot simply fork the project with full git history.
What is the original motivation for archiving deprecated projects? What are the downsides of keeping them around, considering they are public and thus don't incur any GitHub charges?
Add DEPRECATED to the GitHub repo description (ie. DEPRECATED An example that demonstrates...)
For projects published to any registry (npmjs.org, Maven, nuget, etc.), I think we should offer community members a chance to take over the maintenance, so that the project can live on.
Seconded, we shouldn't be making them private unless there's a very good reason to do so (legal issues, for example). If we are simply retiring a module, and the goal is to de-clutter, we should just be moving it to strongloop-community and leaving it public.
What is the original motivation for archiving deprecated projects?
It was decided awhile back from a discussion with @altsang to mark repos as private, then move them to the strongloop-archive org. I originally wanted to keep the code public (so people can still reference the code if they need, etc), but @altsang said we don't want any comments/maintenance on the old projects, just mark them as private and move them there. Then he gave me perms (and @crandmck) to archive projects via that process. Anyways, the movtivation for this new discussion is I don't agree with the current procedures (just like you @sam-github and @rmg), so I want to formalize official procedures in the LoopBack wiki and make it public for the community to see.
It confuses users, especially since the npmjs.org website will still contain a link to the GitHub repository. It also makes it more difficult for community members to take over the project, as they cannot simply fork the project with full git history.
+1
why would we make a repo private once its published?
I agree this has no benefit to the open source community.
Seconded, we shouldn't be making them private unless there's a very good reason to do so (legal issues, for example). If we are simply retiring a module, and the goal is to de-clutter, we should just be moving it to strongloop-community and leaving it public.
+1 for only privating for legal or executive decisions.
+1 for decluttering and moving to strongloop-community
In addition to those comments, if we want to declutter private repos (that are legal/executive decisions) in the strongloop org, we should move those specific ones to the strongloop-archive org.
@superkhau I think that discussion with @altsang was around example repositories, not published modules, which seems to be what is being discussed here.
I don't know about the original discussion, but for example modules, I've no problem with making them private. But for a package that has been published to npmjs.org, even if we eventually publish a version saying "we don't maintain this anymore", we should leave the package with a valid link to a public github repo, so others have the opportunity to fork and maintain the code, if they want (though they'd have to publish under a new name). Or at least, so they can read the code easily and troubleshoot bugs.
I think that discussion with @altsang was around example repositories, not published modules, which seems to be what is being discussed here.
I was talking about all repos when I spoke to him (which is why I asked about leaving the repo moved to strongloop-archive and leaving it public), but I get the point that published modules should be left pointing to a repo accessible by the community.
Sounds like we are all in agreement on this!
Yes, we are. 👍 I will create a task to formalize this in the wiki. I'll ping you guys again for review when its done.
I would suggest this (No new Ideas here just a compilation):
I really appreciate @superkhau to ask for community involvement in a matter which is usually dictated by the company! Similarly, as much as possible, ask for community feedback before deprecating a module. Strongloop employees can describe why they are deprecating a module and the community could not only participate but can also empathise why its being done.
Move all deprecated projects to a public organisation called, maybe strong-archived or something. This will / should remove all legal / moral obligations of StrongLoop to support this project.
This is how facebook does this : https://github.com/facebookarchive So I guess it is OK for organisations of the size of IBM / Facebook to do this from all standpoints (legal etc.)
Code should always be open! There are TONS of repos on github that are doing well that were originally forks of archived projects. Why stop the innovation, after doing all the hard work to create it in the first place? Why spend money on keeping them private no matter how small the amount? :)
Incase old commits / comments are causing an issue, why not erase the git history and add the archived project to the new GitHub Organisation as a fresh repo with a single commit?
@altsang has been referenced a lot of times in this thread, maybe he can weigh in on this here only?
changed the title [-]Official deprecation notice guidelines[/-][+]Official deprecation notice guidelines for deprecating a GH repository[/+]on Feb 4, 2016
@gaurav21r Thanks for the kind words. It's my goal to make sure everyone in the LB community are getting what you need from us (there is always room for improvement -- we listen and are very flexible regarding change). That said:
Will add these considerations to the guidelines
We have a private org for archiving (strongloop-archive), but I will bring it up and try to see if we can make it public.
Agreed, we are an open source project. However, there are some things that take a bit more work to manage before releasing it out to the wild (ie. configs, old policies, etc).
Not a bad idea, I will bring this up with the team too.
Regarding @altsang, he is no longer with the company so we'll have to continue the without him from hereon out.
Activity
philarmour commentedon Jan 4, 2016
This appears to be the current answer (at least according to SO) for "retiring" a project: http://stackoverflow.com/a/22597985/4413888
Also, you reference "Archiving the repo", but I'm not really clear on what you mean. As best I can tell, Github doesn't provide an archive feature: https://help.github.com/articles/can-i-archive-a-repository/ (although there does appear to be 3rd-party support for such functionality.)
superkhau commentedon Jan 4, 2016
Good ideas, will add them to the list in the first comment.
The procedure here at StrongLoop is not to "delete" any repos. We just mark the as private and keep the code in case a need comes up later (like in your case I made the repo public again).
bajtos commentedon Jan 5, 2016
In my opinion, we should not hide (mark as private) any public repositories that are deprecated. It confuses users, especially since the npmjs.org website will still contain a link to the GitHub repository. It also makes it more difficult for community members to take over the project, as they cannot simply fork the project with full git history.
What is the original motivation for archiving deprecated projects? What are the downsides of keeping them around, considering they are public and thus don't incur any GitHub charges?
@ritch @raymondfeng @sam-github @rmg @piscisaureus
bajtos commentedon Jan 5, 2016
For projects published to any registry (npmjs.org, Maven, nuget, etc.), I think we should offer community members a chance to take over the maintenance, so that the project can live on.
sam-github commentedon Jan 5, 2016
I agree with @bajtos, why would we make a repo private once its published?
rmg commentedon Jan 5, 2016
Seconded, we shouldn't be making them private unless there's a very good reason to do so (legal issues, for example). If we are simply retiring a module, and the goal is to de-clutter, we should just be moving it to strongloop-community and leaving it public.
superkhau commentedon Jan 5, 2016
It was decided awhile back from a discussion with @altsang to mark repos as private, then move them to the strongloop-archive org. I originally wanted to keep the code public (so people can still reference the code if they need, etc), but @altsang said we don't want any comments/maintenance on the old projects, just mark them as private and move them there. Then he gave me perms (and @crandmck) to archive projects via that process. Anyways, the movtivation for this new discussion is I don't agree with the current procedures (just like you @sam-github and @rmg), so I want to formalize official procedures in the LoopBack wiki and make it public for the community to see.
+1
I agree this has no benefit to the open source community.
+1 for only privating for legal or executive decisions.
+1 for decluttering and moving to strongloop-community
In addition to those comments, if we want to declutter private repos (that are legal/executive decisions) in the strongloop org, we should move those specific ones to the strongloop-archive org.
Thanks everyone for the comments so far.
rmg commentedon Jan 5, 2016
@superkhau I think that discussion with @altsang was around example repositories, not published modules, which seems to be what is being discussed here.
sam-github commentedon Jan 6, 2016
I don't know about the original discussion, but for example modules, I've no problem with making them private. But for a package that has been published to npmjs.org, even if we eventually publish a version saying "we don't maintain this anymore", we should leave the package with a valid link to a public github repo, so others have the opportunity to fork and maintain the code, if they want (though they'd have to publish under a new name). Or at least, so they can read the code easily and troubleshoot bugs.
Sounds like we are all in agreement on this!
superkhau commentedon Jan 7, 2016
I was talking about all repos when I spoke to him (which is why I asked about leaving the repo moved to strongloop-archive and leaving it public), but I get the point that published modules should be left pointing to a repo accessible by the community.
Yes, we are. 👍 I will create a task to formalize this in the wiki. I'll ping you guys again for review when its done.
gaurav21r commentedon Jan 28, 2016
I would suggest this (No new Ideas here just a compilation):
This is how facebook does this : https://github.com/facebookarchive So I guess it is OK for organisations of the size of IBM / Facebook to do this from all standpoints (legal etc.)
@altsang has been referenced a lot of times in this thread, maybe he can weigh in on this here only?
[-]Official deprecation notice guidelines[/-][+]Official deprecation notice guidelines for deprecating a GH repository[/+]superkhau commentedon Feb 4, 2016
Connect to https://github.com/strongloop-internal/scrum-loopback/issues/698
superkhau commentedon Jul 13, 2016
@gaurav21r Thanks for the kind words. It's my goal to make sure everyone in the LB community are getting what you need from us (there is always room for improvement -- we listen and are very flexible regarding change). That said:
Regarding @altsang, he is no longer with the company so we'll have to continue the without him from hereon out.