--
You received this message because you are subscribed to the Google Groups "kubernetes-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-de...@googlegroups.com.
To post to this group, send email to kuberne...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/CAD2oYtMnhs4Su74nH_-YtJrpV8j0h21K1bDThqu0UBDLy86hMg%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/CAH16ShJebBeq4EhoWNeDrH4W7ymzFQeST6THJ%3DV414OGfUFNgQ%40mail.gmail.com.
A project template would be useful, thanks.
The problem we have is that multi-purpose/big Github repos are unmanageable. We hit the limits of a single repo a year ago in the main repo, and lots of stuff in contrib is rotting.
We need to put new things in new repos, and we need to move existing things to new repos. Contrib needs to be eliminated.
kube-ui was obsoleted by dashboard. We could probably delete it at this point.
kube2consul was created so that PRs against the main repo could be retargeted to it.
demos-and-tutorials was created so that we could move some existing content to it, but nobody has had the time to do that. We perhaps could delete it until we're ready.What is your specific concern?
On Thursday, June 23, 2016 at 11:14:49 AM UTC-7, Brandon Philips wrote:Hello Everyone-We have a number of repos on github.com/kubernetes all of varying quality. A few examples:github.com/kubernetes/kube2consul - brand new no docsgithub.com/kubernetes/kube-ui - no updates since Febgithub.com/kubernetes/demos-and-tutorials - created in March, no updatesI think we should create some sort of minimal process to create a new repo.The repo to be created will first be fully made under a users personal github account and must have:- a README outlining the project including the mailing list contact for discussion, and the slack k8s channel- an OWNERS file outlining who is ultimately responsible- a CONTRIBUTING file based on kubernetes/kubernetes- a code-of-conduct.md based on kubernetes/code-of-conduct.md- a LICENSE file with the intended license- a RELEASE.md file that talks about the process for releasesOnce all of this is created the people in the owners file can email kubernetes-dev discussing their intention to create a new project.If this all seems reasonable I will create a github.com/philips/kubernetes-project-template that includes some of this boilerplate and make it the first thing to go through this process. And then maintain it for all new projects going forward so we at least have consistency in things like LICENSE, RELEASE, CONTRIBUTING and code-of-conduct.Now, the tricky part is who approves the project for creation? Do we have any process for doing that? Maybe we have to get a sig to sponsor it?Also, how do we delete a repo? Probably the simplest thing would be to just ask the owners to abandon it and ask for deletion or archive.Thanks!Brandon
--
You received this message because you are subscribed to the Google Groups "kubernetes-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-de...@googlegroups.com.
To post to this group, send email to kuberne...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/9c6d0789-7841-4f2f-a50b-49b045b65476%40googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/CAD2oYtOTef3jx163g2caHo34hFbhu-WdRi11iLe6kBY2OjSOeQ%40mail.gmail.com.
On Thu, Jun 23, 2016 at 11:14 AM 'Brian Grant' via kubernetes-dev <kuberne...@googlegroups.com> wrote:A project template would be useful, thanks.Great, I will try and get it built today.
One thing to consider-- I just sat down with someone who's going to work on getting our tooling to run against multiple repositories. Hopefully consistent tooling will make contrib & friends less of a wasteland.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/CAB_J3bbxXuLQrYa_3e%3D9347WX-w-EksHX_HEogegn8B0PEnWBw%40mail.gmail.com.
On Thu, Jun 23, 2016 at 11:14 AM 'Brian Grant' via kubernetes-dev <kuberne...@googlegroups.com> wrote:A project template would be useful, thanks.Great, I will try and get it built today.The problem we have is that multi-purpose/big Github repos are unmanageable. We hit the limits of a single repo a year ago in the main repo, and lots of stuff in contrib is rotting.Totally agree. kube-deploy is turning into this.
We need to put new things in new repos, and we need to move existing things to new repos. Contrib needs to be eliminated.If we break contrib into 35 separate repos, is this a good outcome?
It sounds intractable and puts an official looking stamp on a collection of random things.
Perhaps we should create a different github.com/kubernetes-contrib organization that can be a rallying point for stuff like this?
Then we can set a really low threshold like "must be kubernetes related" to the projects and just let it be wild west.kube-ui was obsoleted by dashboard. We could probably delete it at this point.Who makes that decision?
kube2consul was created so that PRs against the main repo could be retargeted to it.Should we try this process out here? Maybe have a sig sponsor the work? Otherwise it feels like this is just a nice community project that can live in someone's personal organization or git repo.
demos-and-tutorials was created so that we could move some existing content to it, but nobody has had the time to do that. We perhaps could delete it until we're ready.What is your specific concern?My specific concern is we are creating a bunch of repos that will look "officialish". When really they are just random pseudo-related projects. I want to set some sort of minimum bar so the entire github.com/kubernetes org doesn't just become a mess of half finished code like the contrib repo.
On Fri, Jun 24, 2016 at 4:28 PM, Brandon Philips <brandon...@coreos.com> wrote:On Thu, Jun 23, 2016 at 11:14 AM 'Brian Grant' via kubernetes-dev <kuberne...@googlegroups.com> wrote:I'd like to make a similar policy about cloudprovider implementations, examples, and other contributions that we aren't able to maintain on our own. Actually, I'm much more concerned about cloud integrations / getting-started guides than with contrib. I would like to make it feasible for them not to be in the main repo, at which point they wouldn't necessarily have to live under the kubernetes github org, either.
On Fri, Jun 24, 2016 at 5:28 PM Brian Grant <brian...@google.com> wrote:
On Fri, Jun 24, 2016 at 4:28 PM, Brandon Philips <brandon...@coreos.com> wrote:
On Thu, Jun 23, 2016 at 11:14 AM 'Brian Grant' via kubernetes-dev <kubernetes-dev@googlegroups.com> wrote:I'd like to make a similar policy about cloudprovider implementations, examples, and other contributions that we aren't able to maintain on our own. Actually, I'm much more concerned about cloud integrations / getting-started guides than with contrib. I would like to make it feasible for them not to be in the main repo, at which point they wouldn't necessarily have to live under the kubernetes github org, either.
Maybe we can start slow with the cloud providers being the first external projects? They are critical to the success of Kubernetes and have a clear SIG sponsor. Plus, given we all have vested interest in cloud provider project success it is easier to rationalize getting the infra and testing stuff in place.Then if there is great success with cloud providers we can consider other projects that are more indirectly tied to Kubernetes's success.
How about encouraging repos in the org to encode compatibility in a machine-readable way (git tag/sha)? Assuming the declared versions were tested, it could help to be more objective about what's being actively maintained, and could even be automated.
$ head meta/compat.json
{
"kubernetes": {
"min": "v1.2.3",
"max": "v1.4.0-alpha.1"
}
}
On Fri, Jun 24, 2016 at 4:28 PM Brandon Philips <brandon...@coreos.com> wrote:
I also want to move docs/{devel,proposals,design} out of the kubernetes repo.
This LGTM for the first version. Now which repo should we put it in? :-)
I also want to move docs/{devel,proposals,design} out of the kubernetes repo.
I think the obvious possible choices are the features and community repos (possibly renamed).
On Friday, June 24, 2016 at 5:02:43 PM UTC-7, Brandon Philips wrote:
On Fri, Jun 24, 2016 at 4:28 PM Brandon Philips <brandon...@coreos.com> wrote:
Hello Everyone-We have a number of repos on github.com/kubernetes all of varying quality. A few examples:github.com/kubernetes/kube2consul - brand new no docsgithub.com/kubernetes/kube-ui - no updates since Febgithub.com/kubernetes/demos-and-tutorials - created in March, no updatesI think we should create some sort of minimal process to create a new repo.The repo to be created will first be fully made under a users personal github account and must have:
- a README outlining the project including the mailing list contact for discussion, and the slack k8s channel- an OWNERS file outlining who is ultimately responsible- a CONTRIBUTING file based on kubernetes/kubernetes- a code-of-conduct.md based on kubernetes/code-of-conduct.md- a LICENSE file with the intended license- a RELEASE.md file that talks about the process for releasesOnce all of this is created the people in the owners file can email kubernetes-dev discussing their intention to create a new project.If this all seems reasonable I will create a github.com/philips/kubernetes-project-template that includes some of this boilerplate and make it the first thing to go through this process. And then maintain it for all new projects going forward so we at least have consistency in things like LICENSE, RELEASE, CONTRIBUTING and code-of-conduct.
On Thursday, June 23, 2016 at 11:14:49 AM UTC-7, Brandon Philips wrote:The repo to be created will first be fully made under a users personal github account and must have:This approach sounded reasonable, especially for new projects, but we've encountered some challenges.1. Where we have existing code in other Kubernetes repo, it complicates ownership to move it out of the kubernetes github org to a personal repo. The github-related tools are in this category. I consider this to be just code reorganization, so I'd like to create these repos ASAP. We can reorganize them again later if needed.
2. Where people from multiple organizations want to work together on a project, we'd probably need to go through a heavy-weight donation / legal process, such as with donating a standalone project to CNCF. If we start in the Kubernetes org from the beginning, then we can ensure everyone signs the appropriate CLA, ownership is clear from the beginning, and it can be accomplished in a bounded amount of time.
3. Post-development transfers of IP even from individual companies can be more complex than incremental contributions to an existing project, as mentioned in the thread about the node-feature-discovery repo.
I forked this repo, with no changes, into the kubernetes org, to make it more discoverable.
On Tue, Aug 2, 2016 at 2:49 PM, Brandon Philips
wrote:
> Do we know for sure that the donation / legal process is complex for moving repos?
In our case moving the repo isn't a big deal. Prior to moving however,
the repo needs to be public and that requires new approval.
+1 for incubator prefix, follows precedent from the ASF. It would be
helpful to make the criteria for "graduation" from incubator status
explicit ahead of time so owners know what to shoot for and decisions
remain transparent and consistent.
On Thu, Jul 28, 2016 at 5:32 PM 'Brian Grant' via kubernetes-dev <kuberne...@googlegroups.com> wrote:On Thursday, June 23, 2016 at 11:14:49 AM UTC-7, Brandon Philips wrote:The repo to be created will first be fully made under a users personal github account and must have:This approach sounded reasonable, especially for new projects, but we've encountered some challenges.1. Where we have existing code in other Kubernetes repo, it complicates ownership to move it out of the kubernetes github org to a personal repo. The github-related tools are in this category. I consider this to be just code reorganization, so I'd like to create these repos ASAP. We can reorganize them again later if needed.That is fine. I think we can have a fast track for "code moves". Probably makes sense to still write to kubernetes-dev.
2. Where people from multiple organizations want to work together on a project, we'd probably need to go through a heavy-weight donation / legal process, such as with donating a standalone project to CNCF. If we start in the Kubernetes org from the beginning, then we can ensure everyone signs the appropriate CLA, ownership is clear from the beginning, and it can be accomplished in a bounded amount of time.Hrm, OK. I don't know how to resolve this. I don't think we should just start throwing out repos to anyone who comes up with an idea either. Perhaps we say you have to: use the same email as you use for Kubernetes CLA and you must declare the ownership to the CNCF?What do you mean by bounded amount of time?Do we know for sure that the donation / legal process is complex for moving repos?3. Post-development transfers of IP even from individual companies can be more complex than incremental contributions to an existing project, as mentioned in the thread about the node-feature-discovery repo.OK, perhaps we create github.com/kubernetes-incubator? Or we prefix every new project with incubator-$FOO and people have 3-6 months to make the case that the project is important through releases, community, and users? If the case can't be made we ask that they pull the repo out.I forked this repo, with no changes, into the kubernetes org, to make it more discoverable.Can you make me owner of the fork so I can keep it up to date, if necessary?Thank You,Brandon
--
You received this message because you are subscribed to the Google Groups "kubernetes-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-de...@googlegroups.com.
To post to this group, send email to kuberne...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/CAD2oYtM3YwvWRdtKxdk4KTMR4wPDDM-Swc_OHZfiFOSQsW5tWg%40mail.gmail.com.
You received this message because you are subscribed to the Google Groups "Kubernetes developer/contributor discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-de...@googlegroups.com.
To post to this group, send email to kuberne...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-dev/e5c4c8d6-da52-4168-95dd-b6f39c4551fe%40googlegroups.com.