From 0686661aed2483a07c163ee900982b7414972533 Mon Sep 17 00:00:00 2001 From: Christoph Blecker Date: Wed, 24 Jan 2018 12:07:28 -0800 Subject: [PATCH] Modify sig docs generator to handle multiple meetings --- generator/app.go | 29 +++++++++++++++-------------- generator/list.tmpl | 4 ++-- generator/sig_readme.tmpl | 18 +++++++++--------- generator/wg_readme.tmpl | 18 +++++++++--------- 4 files changed, 35 insertions(+), 34 deletions(-) diff --git a/generator/app.go b/generator/app.go index e7694b5b9..79e08cd35 100644 --- a/generator/app.go +++ b/generator/app.go @@ -58,10 +58,14 @@ type Lead struct { // Meeting represents a regular meeting for a group. type Meeting struct { - Day string - Time string - TZ string `yaml:"tz"` - Frequency string + Description string + Day string + Time string + TZ string + Frequency string + URL string + ArchiveURL string `yaml:"archive_url"` + RecordingsURL string `yaml:"recordings_url"` } // Contact represents the various contact points for a group. @@ -79,16 +83,13 @@ type GithubTeams struct { // Group represents either a Special Interest Group (SIG) or a Working Group (WG) type Group struct { - Name string - Dir string - MissionStatement string `yaml:"mission_statement"` - Label string - Leads []Lead - Meetings []Meeting - MeetingURL string `yaml:"meeting_url"` - MeetingArchiveURL string `yaml:"meeting_archive_url"` - MeetingRecordingsURL string `yaml:"meeting_recordings_url"` - Contact Contact + Name string + Dir string + MissionStatement string `yaml:"mission_statement"` + Label string + Leads []Lead + Meetings []Meeting + Contact Contact } // DirName returns the directory that a group's documentation will be diff --git a/generator/list.tmpl b/generator/list.tmpl index 38ddc0e19..17ece912d 100644 --- a/generator/list.tmpl +++ b/generator/list.tmpl @@ -16,7 +16,7 @@ When the need arises, a [new SIG can be created](sig-creation-procedure.md) | Name | Label | Leads | Contact | Meetings | |------|--------|-------|---------|----------| {{- range .Sigs}} -|[{{.Name}}]({{.Dir}}/README.md)|{{.Label}}|{{range .Leads}}* [{{.Name}}](https://github.com/{{.GitHub}}){{if .Company}}, {{.Company}}{{end}}
{{end}}|* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}})
* [Mailing List]({{.Contact.MailingList}})|{{ $save := . }}{{range .Meetings}}* [{{.Day}}s at {{.Time}} {{.TZ}} ({{.Frequency}})]({{$save.MeetingURL}})
{{end}} +|[{{.Name}}]({{.Dir}}/README.md)|{{.Label}}|{{range .Leads}}* [{{.Name}}](https://github.com/{{.GitHub}}){{if .Company}}, {{.Company}}{{end}}
{{end}}|* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}})
* [Mailing List]({{.Contact.MailingList}})|{{ $save := . }}{{range .Meetings}}* {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}} ({{.Frequency}})]({{.URL}})
{{end}} {{- end }} ### Master Working Group List @@ -24,5 +24,5 @@ When the need arises, a [new SIG can be created](sig-creation-procedure.md) | Name | Organizers | Contact | Meetings | |------|------------|---------|----------| {{- range .WorkingGroups}} -|[{{.Name}}]({{.Dir}}/README.md)|{{range .Leads}}* [{{.Name}}](https://github.com/{{.GitHub}}){{if .Company}}, {{.Company}}{{end}}
{{end}}|* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}})
* [Mailing List]({{.Contact.MailingList}})|{{ $save := . }}{{range .Meetings}}* [{{.Day}}s at {{.Time}} {{.TZ}} ({{.Frequency}})]({{$save.MeetingURL}})
{{end}} +|[{{.Name}}]({{.Dir}}/README.md)|{{range .Leads}}* [{{.Name}}](https://github.com/{{.GitHub}}){{if .Company}}, {{.Company}}{{end}}
{{end}}|* [Slack](https://kubernetes.slack.com/messages/{{.Contact.Slack}})
* [Mailing List]({{.Contact.MailingList}})|{{ $save := . }}{{range .Meetings}}* {{.Description}}: [{{.Day}}s at {{.Time}} {{.TZ}} ({{.Frequency}})]({{.URL}})
{{end}} {{- end }} diff --git a/generator/sig_readme.tmpl b/generator/sig_readme.tmpl index c5aea6d4e..2b3582efa 100644 --- a/generator/sig_readme.tmpl +++ b/generator/sig_readme.tmpl @@ -2,18 +2,18 @@ # {{.Name}} SIG {{ .MissionStatement }} -## Meetings +{{ if .Meetings }}## Meetings {{- range .Meetings }} -* [{{.Day}}s at {{.Time}} {{.TZ}}]({{$.MeetingURL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). -{{- end }} - -{{ if .MeetingArchiveURL -}} -Meeting notes and Agenda can be found [here]({{.MeetingArchiveURL}}). -{{- end }} -{{ if .MeetingRecordingsURL -}} -Meeting recordings can be found [here]({{.MeetingRecordingsURL}}). +* {{.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 -}} ## Leads {{- range .Leads }} * {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}} diff --git a/generator/wg_readme.tmpl b/generator/wg_readme.tmpl index cd9cc2fd5..5cd75e66c 100644 --- a/generator/wg_readme.tmpl +++ b/generator/wg_readme.tmpl @@ -2,18 +2,18 @@ # {{.Name}} Working Group {{ .MissionStatement }} -## Meetings +{{ if .Meetings }}## Meetings {{- range .Meetings }} -* [{{.Day}}s at {{.Time}} {{.TZ}}]({{$.MeetingURL}}) ({{.Frequency}}). [Convert to your timezone](http://www.thetimezoneconverter.com/?t={{.Time}}&tz={{.TZ | tzUrlEncode}}). -{{- end }} - -{{ if .MeetingArchiveURL -}} -Meeting notes and Agenda can be found [here]({{.MeetingArchiveURL}}). -{{- end }} -{{ if .MeetingRecordingsURL -}} -Meeting recordings can be found [here]({{.MeetingRecordingsURL}}). +* {{.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 -}} ## Organizers {{- range .Leads }} * {{.Name}} (**[@{{.GitHub}}](https://github.com/{{.GitHub}})**){{if .Company}}, {{.Company}}{{end}}