From 720b9e96829bab25b4ee5587c10d5bc19c18add7 Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Wed, 24 Jul 2019 20:35:10 +0530 Subject: generator: add emeritus leads to WG and UG template --- generator/ug_readme.tmpl | 7 +++++++ generator/wg_readme.tmpl | 7 +++++++ 2 files changed, 14 insertions(+) (limited to 'generator') diff --git a/generator/ug_readme.tmpl b/generator/ug_readme.tmpl index e665f0e8..9ec0d4db 100644 --- a/generator/ug_readme.tmpl +++ b/generator/ug_readme.tmpl @@ -26,6 +26,13 @@ The [charter]({{.CharterLink}}) defines the scope and governance of the {{.Name} * {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}} {{- end }} {{- end }} +{{- if .Leadership.EmeritusLeads }} + +## Emeritus Organizers +{{ range .Leadership.EmeritusLeads }} +* {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}} +{{- end }} +{{- end }} {{- end }} ## Contact diff --git a/generator/wg_readme.tmpl b/generator/wg_readme.tmpl index ed3bb99f..e1c22df3 100644 --- a/generator/wg_readme.tmpl +++ b/generator/wg_readme.tmpl @@ -32,6 +32,13 @@ The [charter]({{.CharterLink}}) defines the scope and governance of the {{.Name} * {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}} {{- end }} {{- end }} +{{- if .Leadership.EmeritusLeads }} + +## Emeritus Organizers +{{ range .Leadership.EmeritusLeads }} +* {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}} +{{- end }} +{{- end }} {{- end }} ## Contact -- cgit v1.2.3 From a33d5ffe2307a0a458d883938c97249a5ca969a4 Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Tue, 30 Jul 2019 19:23:08 +0530 Subject: generator: enable validation for sigs.yaml --- generator/app.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'generator') diff --git a/generator/app.go b/generator/app.go index 371add2a..a5f05b1f 100644 --- a/generator/app.go +++ b/generator/app.go @@ -468,9 +468,9 @@ func main() { errs := ctx.Validate() if len(errs) != 0 { for _, err := range errs { - fmt.Printf("NOTICE: %s\n", err.Error()) + fmt.Printf("ERROR: %s\n", err.Error()) } - fmt.Println("NOTICE: validation errors are ignored at present") + os.Exit(1) } // Write the Context struct back to yaml to enforce formatting -- cgit v1.2.3 From c8f1173de064b11ceb888aad26d1309fa7575d33 Mon Sep 17 00:00:00 2001 From: Aaron Crickenberger Date: Thu, 8 Aug 2019 11:43:00 -0700 Subject: Make subprojects linkable, move github teams under contacts This commit only contains the generator changes for easier review The bulleted list of subprojects makes it impossible to link someone to specific info for a given subproject. Now, instead of linking someone to sig-testing#subprojects and asking them to scroll, I link them directly to sig-testing#kind. While I was at this, I made the main SIG/WG/UG/Committee contact info format match what is used for subprojects, specifically: - display the slack channel name - list github teams as part of contact info instead of in a table - use - instead of * for bullets I also removed subproject rendering from WGs, since WGs cannot own code, and added a link to the governance definition of what a subproject is. --- generator/committee_readme.tmpl | 60 ++++++++++++++++++++++++----------------- generator/sig_readme.tmpl | 53 +++++++++++++++++------------------- generator/ug_readme.tmpl | 21 +++++---------- generator/wg_readme.tmpl | 49 +++++---------------------------- 4 files changed, 75 insertions(+), 108 deletions(-) (limited to 'generator') diff --git a/generator/committee_readme.tmpl b/generator/committee_readme.tmpl index d84bd2b5..68b5b893 100644 --- a/generator/committee_readme.tmpl +++ b/generator/committee_readme.tmpl @@ -32,55 +32,67 @@ The [charter]({{.CharterLink}}) defines the scope and governance of the {{.Name} ## Contact {{- if .Contact.Slack }} -* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) +- Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) {{- end }} {{- if .Contact.MailingList }} -* [Mailing list]({{.Contact.MailingList}}) +- [Mailing list]({{.Contact.MailingList}}) {{- end }} {{- if .Contact.PrivateMailingList }} -* Private Mailing List: {{.Contact.PrivateMailingList}} +- Private Mailing List: {{.Contact.PrivateMailingList}} {{- end }} {{- if .Label }} -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/ug%2F{{.Label}}) +- [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/committee%2F{{.Label}}) {{- end }} +{{- if .Contact.GithubTeams }} +- GitHub Teams: +{{- range .Contact.GithubTeams }} + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}} {{- end}} +{{- end }} +{{- end }} + {{- if .Subprojects }} ## Subprojects -The following subprojects are owned by the {{.Name}} Committee: +The following [subprojects][subproject-definition] are owned by the {{.Name}} Committee: {{- range .Subprojects }} -- **{{.Name}}** +### {{.Name}} {{- if .Description }} - - Description: {{ trimSpace .Description }} +{{ trimSpace .Description }} {{- end }} - - Owners: +- **Owners:** {{- range .Owners }} - - {{.}} + - {{.}} +{{- end }} +{{- if .Contact }} +- **Contact:** +{{- if .Contact.Slack }} + - Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) +{{- end }} +{{- if .Contact.MailingList }} + - [Mailing List]({{.Contact.MailingList}}) +{{- end }} +{{- if .Contact.GithubTeams }} + - GitHub Teams: +{{- range .Contact.GithubTeams }} + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}}{{- end}} +{{- end }} +{{- end }} {{- end }} {{- if .Meetings }} - - Meetings: +- **Meetings:** {{- range .Meetings }} - - {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}}]({{.URL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). + - {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}}]({{.URL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). {{- if .ArchiveURL }} - - [Meeting notes and Agenda]({{.ArchiveURL}}). + - [Meeting notes and Agenda]({{.ArchiveURL}}). {{- end }} {{- if .RecordingsURL }} - - [Meeting recordings]({{.RecordingsURL}}). + - [Meeting recordings]({{.RecordingsURL}}). {{- end }} {{- end }} {{- end }} {{- end }} {{- end }} -{{ if .Contact.GithubTeams }} -## GitHub Teams -The below teams can be mentioned on issues and PRs in order to get attention from the right people. -Note that the links to display team membership will only work if you are a member of the org. - -| Team Name | Details | Description | -| --------- |:-------:| ----------- | -{{- range .Contact.GithubTeams }} -| @kubernetes/{{.Name}} | [link](https://github.com/orgs/kubernetes/teams/{{.Name}}) | {{.Description}} | -{{- end }} -{{ end }} +[subproject-definition]: https://github.com/kubernetes/community/blob/master/governance.md#subprojects diff --git a/generator/sig_readme.tmpl b/generator/sig_readme.tmpl index 734c1512..12ad5bb4 100644 --- a/generator/sig_readme.tmpl +++ b/generator/sig_readme.tmpl @@ -48,64 +48,61 @@ subprojects, and resolve cross-subproject technical issues and decisions. {{- end }} ## Contact -* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) -* [Mailing list]({{.Contact.MailingList}}) +- Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) +- [Mailing list]({{.Contact.MailingList}}) {{- if .Label }} -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2F{{.Label}}) +- [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2F{{.Label}}) {{- end }} +{{- if .Contact.GithubTeams }} +- GitHub Teams: +{{- range .Contact.GithubTeams }} + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}} {{- end}} +{{- end }} +{{- end }} + {{- if .Subprojects }} ## Subprojects -The following subprojects are owned by sig-{{.Label}}: +The following [subprojects][subproject-definition] are owned by sig-{{.Label}}: {{- range .Subprojects }} -- **{{.Name}}** +### {{.Name}} {{- if .Description }} - - Description: {{ trimSpace .Description }} +{{ trimSpace .Description }} {{- end }} - - Owners: +- **Owners:** {{- range .Owners }} - - {{.}} + - {{.}} {{- end }} {{- if .Contact }} - - Contact +- **Contact:** {{- if .Contact.Slack }} - - Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) + - Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) {{- end }} {{- if .Contact.MailingList }} - - [Mailing List]({{.Contact.MailingList}}) + - [Mailing List]({{.Contact.MailingList}}) {{- end }} {{- if .Contact.GithubTeams }} - - GitHub Teams: + - GitHub Teams: {{- range .Contact.GithubTeams }} - - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }}({{.Description}}){{- end}} + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}}{{- end}} {{- end }} {{- end }} {{- end }} {{- if .Meetings }} - - Meetings: +- **Meetings:** {{- range .Meetings }} - - {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}}]({{.URL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). + - {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}}]({{.URL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). {{- if .ArchiveURL }} - - [Meeting notes and Agenda]({{.ArchiveURL}}). + - [Meeting notes and Agenda]({{.ArchiveURL}}). {{- end }} {{- if .RecordingsURL }} - - [Meeting recordings]({{.RecordingsURL}}). + - [Meeting recordings]({{.RecordingsURL}}). {{- end }} {{- end }} {{- end }} {{- end }} {{- end }} -{{ if .Contact.GithubTeams }} -## GitHub Teams - -The below teams can be mentioned on issues and PRs in order to get attention from the right people. -Note that the links to display team membership will only work if you are a member of the org. -| Team Name | Details | Description | -| --------- |:-------:| ----------- | -{{- range .Contact.GithubTeams }} -| @kubernetes/{{.Name}} | [link](https://github.com/orgs/kubernetes/teams/{{.Name}}) | {{.Description}} | -{{- end }} -{{ end }} +[subproject-definition]: https://github.com/kubernetes/community/blob/master/governance.md#subprojects diff --git a/generator/ug_readme.tmpl b/generator/ug_readme.tmpl index 9ec0d4db..4062128e 100644 --- a/generator/ug_readme.tmpl +++ b/generator/ug_readme.tmpl @@ -36,21 +36,14 @@ The [charter]({{.CharterLink}}) defines the scope and governance of the {{.Name} {{- end }} ## Contact -* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) -* [Mailing list]({{.Contact.MailingList}}) +- Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) +- [Mailing list]({{.Contact.MailingList}}) {{- if .Label }} -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/ug%2F{{.Label}}) +- [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/ug%2F{{.Label}}) {{- end }} - -{{ if .Contact.GithubTeams }} -## GitHub Teams - -The below teams can be mentioned on issues and PRs in order to get attention from the right people. -Note that the links to display team membership will only work if you are a member of the org. - -| Team Name | Details | Description | -| --------- |:-------:| ----------- | +{{- if .Contact.GithubTeams }} +- GitHub Teams: {{- range .Contact.GithubTeams }} -| @kubernetes/{{.Name}} | [link](https://github.com/orgs/kubernetes/teams/{{.Name}}) | {{.Description}} | + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}} {{- end}} +{{- end }} {{- end }} -{{ end }} diff --git a/generator/wg_readme.tmpl b/generator/wg_readme.tmpl index e1c22df3..0fc7ff47 100644 --- a/generator/wg_readme.tmpl +++ b/generator/wg_readme.tmpl @@ -42,49 +42,14 @@ The [charter]({{.CharterLink}}) defines the scope and governance of the {{.Name} {{- end }} ## Contact -* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) -* [Mailing list]({{.Contact.MailingList}}) +- Slack: [#{{.Contact.Slack}}](https://kubernetes.slack.com/messages/{{.Contact.Slack}}) +- [Mailing list]({{.Contact.MailingList}}) {{- if .Label }} -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/wg%2F{{.Label}}) +- [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/wg%2F{{.Label}}) {{- end }} -{{- if .Subprojects }} - -## Subprojects - -The following subprojects are owned by wg-{{.Label}}: - -{{- range .Subprojects }} -- **{{.Name}}** -{{- if .Description }} - - Description: {{ .Description }} -{{- end }} - - Owners: -{{- range .Owners }} - - {{.}} -{{- end }} -{{- if .Meetings }} - - Meetings: -{{- range .Meetings }} - - {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}}]({{.URL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). -{{- if .ArchiveURL }} - - [Meeting notes and Agenda]({{.ArchiveURL}}). -{{- end }} -{{- if .RecordingsURL }} - - [Meeting recordings]({{.RecordingsURL}}). -{{- end }} -{{- end }} -{{- end }} -{{- end }} -{{- end }} -{{ if .Contact.GithubTeams }} -## GitHub Teams - -The below teams can be mentioned on issues and PRs in order to get attention from the right people. -Note that the links to display team membership will only work if you are a member of the org. - -| Team Name | Details | Description | -| --------- |:-------:| ----------- | +{{- if .Contact.GithubTeams }} +- GitHub Teams: {{- range .Contact.GithubTeams }} -| @kubernetes/{{.Name}} | [link](https://github.com/orgs/kubernetes/teams/{{.Name}}) | {{.Description}} | + - [@kubernetes/{{.Name}}](https://github.com/orgs/kubernetes/teams/{{.Name}}) {{- if .Description }} - {{.Description}} {{- end}} +{{- end }} {{- end }} -{{ end }} -- cgit v1.2.3