sig name consistency

[spiffxp]

There are a number of places where sig names are ever-so-slightly inconsistent. I'd like us to link back to this issue when we identify those areas. Update docs, preferably adjust what we can.

For a sig foo, I expect:

• a sig-foo entry in kubernetes/community/sigs.yaml
• kubernetes/community/sig-foo/README.md
• sig-foo google group
• sig-foo-* teams in https://github.com/orgs/kubernetes/teams
• sig-foo-* google groups
• k8s-mirror-sig-foo-* github users
• #sig-foo in kubernetes.slack.com
• sig/foo labels
• sig-foo to appear in the list of valid test job owners

Examples of where we've hit inconsistencies:

• https://groups.google.com/forum/#!topic/kubernetes-wg-contribex/Bo0TnJEljoA
• Added Slack Client to the list of plugins. test-infra#2846 (comment)

EDIT: Is it reasonable to expect the same for working groups as well?

[spiffxp]

FYI @kubernetes/sig-contributor-experience-misc

[spiffxp]

FYI @xiangpengzhao

[xiangpengzhao]

+1000

It would be good to also have our sig meeting channels follow the name consistency.

In the page SIGs and Working Groups, we use hangouts or zoom to hold meetings. And some meeting channels use number as id and others use name string.

@spiffxp

[spiffxp]

ping @castrojo since we were talking about this the other day

[idvoretskyi]

big +1

[castrojo]

So what I was thinking was proposing something to the SIG governance document that reads something like "The entry dir: sig-api-machinery in sigs.yaml becomes the machine-consumable naming convention that all your other resources inherit."

Then we make sure the slack channels, etc. align up. Renaming the slack channels is easy, we just renamed #sig-scale without problems. Not sure on how disruptive renaming google groups. I think the annoying bit will be the Zoom channels and calendars, which seems to be a mixture of numbers and shortcuts.

However I think we can make the argument to all the leads that being able to just guess the channel name based on convention will be very useful for people, for example I would be able to guess that zoom.us/j/sig-ui is the right room. Calendars will be annoying but making SIGs follow this convention will lead to improved tooling and consistency.

[cblecker]

we can change/update sigs.yaml as needed.. there's actually three lines in there (dir, name, label) that are all similar. Having one as the source of truth, and then changing around the generator as needed would work

[bgrant0607]

Zoom channels should be prefixed with "k8s-" Other open-source communities are adopting SIGs

[spiffxp]

re: zoom-channels, you only get one vanity url aka "Personal Link" via https://zoom.us/profile

Personal Link is an alias of your personal meeting URL https://zoom.us/j/REDACTED.
It must be 5 to 40 characters.
It must start with a letter and can contain only letters (a-z), numbers (0-9) and periods (".")

Couldn't use a dash, so now I've got https://zoom.us/my/k8s.sig.testing, WDYT?

Only other URL I've seen is https://zoom.us/my/kubernetescommunity

[idvoretskyi]

Dots look weird, IMO.

…

On Oct 24, 2017 11:38 PM, "Aaron Crickenberger" ***@***.***> wrote: re: zoom-channels, you only get one vanity url aka "Personal Link" via https://zoom.us/profile Personal Link is an alias of your personal meeting URL https://zoom.us/j/REDACTED. It must be 5 to 40 characters. It must start with a letter and can contain only letters (a-z), numbers (0-9) and periods (".") Couldn't use a dash, so now I've got https://zoom.us/my/k8s.sig.testing, WDYT? Only other URL I've seen is https://zoom.us/my/kubernetescommunity — You are receiving this because you are on a team that was mentioned. Reply to this email directly, view it on GitHub <#703 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAHOu5TiQRl-EYCOlPdPCnSRmvH4E2jIks5svljRgaJpZM4N1w4T> .

[bgrant0607]

dots are better than no punctuation.

An existing example:
https://zoom.us/my/sig.apps

k8s.sig.testing seems fine.

[spiffxp]

Fun (annoying) facts discovered while trying to reconcile for sig-contributor-experience

• renaming a google group will break anything that attempts to use the old name
• slack channel names are limited to 21 characters (sig-contributor-experience is 27)

So we're back to kuberenetes-wg-contribex and #sig-contribex for now

[fejta-bot]

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.

If this issue is safe to close now please do so with /close.

Send feedback to sig-testing, kubernetes/test-infra and/or fejta.
/lifecycle stale

[cblecker]

/remove-lifecycle stale

[fejta-bot]

Issues go stale after 90d of inactivity.
Mark the issue as fresh with /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.

If this issue is safe to close now please do so with /close.

Send feedback to sig-testing, kubernetes/test-infra and/or fejta.
/lifecycle stale

[fejta-bot]

Stale issues rot after 30d of inactivity.
Mark the issue as fresh with /remove-lifecycle rotten.
Rotten issues close after an additional 30d of inactivity.

If this issue is safe to close now please do so with /close.

Send feedback to sig-testing, kubernetes/test-infra and/or fejta.
/lifecycle rotten
/remove-lifecycle stale

[cblecker]

/remove-lifecycle rotten

[spiffxp]

/lifecycle frozen
As a "known issue".

I'm not sure I ever foresee this getting fixed if the definition of done is "make everything the same". I think instead a successful answer to these questions would do it:

• How could these conventions (and deviations from them) best be documented?
  • ie: I'm guessing somewhere in the docs around sig goverenance and sig creation there would be a list of all the things
• Where should a person go to find out about these different things for a given SIG?
  • ie: maybe use sigs.yaml to hold this info and generate it into SIG READMEs?

[parispittman]

sig-wg-lifecycle.md should cover most of these conventions along with the other governance doc updates recently. most of the naming convention information is included in each relevant section. do you think this is good @spiffxp?

contribex ml has also been changed to kubernetes-sig-contribex@

[spiffxp]

/close
Yes, I think between sigs.yaml evolving to hold much of this contact info, and the lifecycle doc spelling out how to implement most of the conventions, we're good here

[k8s-ci-robot]

@spiffxp: Closing this issue.

In response to this:

/close
Yes, I think between sigs.yaml evolving to hold much of this contact info, and the lifecycle doc spelling out how to implement most of the conventions, we're good here

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.