From 6ada1937c1bf13268705702de9061ed8ff990825 Mon Sep 17 00:00:00 2001 From: Kaitlyn Barnard Date: Thu, 20 Jun 2019 12:40:49 -0700 Subject: Update README.md --- sig-docs/blog-subproject/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index 953f4d03..1f9a0191 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -6,15 +6,15 @@ This section covers documentation, processes, and roles for the Kubernetes blog. ## Meetings -Regular Blog Meeting: TBD (biweekly). +Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone](http://www.thetimezoneconverter.com/?t=18:30&tz=UTC) -* Meeting notes and Agenda -* Meeting recording +* [Meeting notes and Agenda](https://docs.google.com/document/d/1W5MKkaQGd3YKKZINzj1tJAQbql5R_Y4KAHlFNsJ44Bc/edit?usp=sharing) +* [Meeting recordings](https://www.youtube.com/playlist?list=PL69nYSiGNLP3b5hlx0YV7Lo7DtckM84y8) ## Leadership * **Editorial Leads:** [Kaitlyn Barnard](https://github.com/kbarnard10), [Zach Corleissen](https://github.com/zacharysarah) (shadow) -* **Technical Editors:** [Bob Killen](https://github.com/mrbobbytables) +* **Technical Editors:** [Bob Killen](https://github.com/mrbobbytables), Taylor Dolezal(@onlydole) (shadow) * **Copy Editors:** [Alex Handy](https://github.com/vonguard), [Cody Clark](https://github.com/cody-clark) * **Blog Community Managers:** [Jorge Castro](https://github.com/castrojo), [Paris Pittman](https://github.com/parispittman) (shadow) @@ -90,7 +90,7 @@ Ultimately, if none of these can be satisfied, responsibility falls to the Edito ### Shadows -We are always open to adding new shadows to the editorial team roles. If you are interested in shadowing one of the roles on the team, please fill out [this application](TBD). We review applications on a rolling basis. +We are always open to adding new shadows to the editorial team roles. If you are interested in shadowing one of the roles on the team, please fill out [this application](The application form is now live for anyone interested in joining the blog editorial team: https://docs.google.com/forms/d/e/1FAIpQLScg9fHsyW-LlsBF8rc9J0sR8u3O3g17lwFUKIE-qrjL6Z-AyA/viewform?usp=sf_link). We review applications on a rolling basis. ### Removing a Team Member -- cgit v1.2.3 From f73900801668577e890d778172c5cc411d5630bd Mon Sep 17 00:00:00 2001 From: "Taylor.J.Dolezal" Date: Tue, 25 Jun 2019 11:26:15 -0700 Subject: Update GitHub link for Onlydole --- sig-docs/blog-subproject/README.md | 50 +++++++++++++++++++------------------- 1 file changed, 25 insertions(+), 25 deletions(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index 1f9a0191..7c186e67 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -8,22 +8,22 @@ This section covers documentation, processes, and roles for the Kubernetes blog. Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone](http://www.thetimezoneconverter.com/?t=18:30&tz=UTC) -* [Meeting notes and Agenda](https://docs.google.com/document/d/1W5MKkaQGd3YKKZINzj1tJAQbql5R_Y4KAHlFNsJ44Bc/edit?usp=sharing) -* [Meeting recordings](https://www.youtube.com/playlist?list=PL69nYSiGNLP3b5hlx0YV7Lo7DtckM84y8) +- [Meeting notes and Agenda](https://docs.google.com/document/d/1W5MKkaQGd3YKKZINzj1tJAQbql5R_Y4KAHlFNsJ44Bc/edit?usp=sharing) +- [Meeting recordings](https://www.youtube.com/playlist?list=PL69nYSiGNLP3b5hlx0YV7Lo7DtckM84y8) ## Leadership -* **Editorial Leads:** [Kaitlyn Barnard](https://github.com/kbarnard10), [Zach Corleissen](https://github.com/zacharysarah) (shadow) -* **Technical Editors:** [Bob Killen](https://github.com/mrbobbytables), Taylor Dolezal(@onlydole) (shadow) -* **Copy Editors:** [Alex Handy](https://github.com/vonguard), [Cody Clark](https://github.com/cody-clark) -* **Blog Community Managers:** [Jorge Castro](https://github.com/castrojo), [Paris Pittman](https://github.com/parispittman) (shadow) +- **Editorial Leads:** [Kaitlyn Barnard](https://github.com/kbarnard10), [Zach Corleissen](https://github.com/zacharysarah) (shadow) +- **Technical Editors:** [Bob Killen](https://github.com/mrbobbytables), [Taylor Dolezal](https://github.com/onlydole) (shadow) +- **Copy Editors:** [Alex Handy](https://github.com/vonguard), [Cody Clark](https://github.com/cody-clark) +- **Blog Community Managers:** [Jorge Castro](https://github.com/castrojo), [Paris Pittman](https://github.com/parispittman) (shadow) ## Contact -* Slack: #kubernetes-docs-blog -* Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) -* Open Community Issues/PRs: area/blog label -* GitHub Team: @kubernetes/sig-docs-blog-reviews +- Slack: #kubernetes-docs-blog +- Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) +- Open Community Issues/PRs: area/blog label +- GitHub Team: @kubernetes/sig-docs-blog-reviews ## Submit a Post @@ -42,25 +42,25 @@ To submit a blog post, you can either submit it using the [Kubernetes blog submi Requested Content (with examples): -* New Kubernetes capabilities -* Kubernetes projects updates -* Updates from Special Interest Groups -* Tutorials and walkthroughs -* Thought leadership around Kubernetes -* Kubernetes Partner OSS integration -* **Original content only** +- New Kubernetes capabilities +- Kubernetes projects updates +- Updates from Special Interest Groups +- Tutorials and walkthroughs +- Thought leadership around Kubernetes +- Kubernetes Partner OSS integration +- **Original content only** Unsuitable Content: -* Vendor product pitches -* Partner updates without an integration and customer story -* Syndicated posts (language translations ok) +- Vendor product pitches +- Partner updates without an integration and customer story +- Syndicated posts (language translations ok) ## Review Process -Once a blog post is submitted either via the form or a PR, it will be routed to the editorial team for review either via email for Google Docs or auto-assigning for a PR. +Once a blog post is submitted either via the form or a PR, it will be routed to the editorial team for review either via email for Google Docs or auto-assigning for a PR. -Each blog post requires a LGTM from one copy editor, technical editor*, and blog community manager. Once the necessary LGTMs are in place, an Editorial Lead will schedule and approve the blog post. +Each blog post requires a LGTM from one copy editor, technical editor\*, and blog community manager. Once the necessary LGTMs are in place, an Editorial Lead will schedule and approve the blog post. _If a blog post does not contain any technical content (for example, [How You Can Help Localize Kubernetes Docs](https://kubernetes.io/blog/2019/04/26/how-you-can-help-localize-kubernetes-docs/)), the technical review can be omitted._ @@ -82,9 +82,9 @@ We typically do not make edits to blog posts more than 1 years old. Each Editorial Team role is responsible for staffing their respective role, with this order of fall-through in mind: -* training and selecting a successor from the current pool of role shadows -* training and selecting a successor from non-Editorial Team members -* staffing the role themselves +- training and selecting a successor from the current pool of role shadows +- training and selecting a successor from non-Editorial Team members +- staffing the role themselves Ultimately, if none of these can be satisfied, responsibility falls to the Editorial Team Lead and SIG-Docs to staff the roles. -- cgit v1.2.3 From 92602eeaf2fc50fd14f41736327ea4e6d3ba82e7 Mon Sep 17 00:00:00 2001 From: "Taylor.J.Dolezal" Date: Wed, 26 Jun 2019 11:16:59 -0700 Subject: Add relevant links to Kubernetes Blog Subproject readme --- sig-docs/blog-subproject/README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index 7c186e67..25d44fc5 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -2,7 +2,7 @@ The Kubernetes Blog Subproject is owned by [SIG-Docs](https://github.com/kubernetes/community/tree/master/sig-docs) and run by the [Editorial Team](#leadership). -This section covers documentation, processes, and roles for the Kubernetes blog. +This section covers documentation, processes, and roles for the [Kubernetes blog](https://kubernetes.io/blog/). ## Meetings @@ -20,10 +20,10 @@ Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone]( ## Contact -- Slack: #kubernetes-docs-blog +- Slack: [#kubernetes-docs-blog](https://kubernetes.slack.com/messages/CJDHVD54J) - Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) -- Open Community Issues/PRs: area/blog label -- GitHub Team: @kubernetes/sig-docs-blog-reviews +- Open Community Issues/PRs: `area/blog` label +- GitHub Teams: [kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog), [kubernetes-blog-maintainers](https://github.com/orgs/kubernetes/teams/kubernetes-blog-maintainers) ## Submit a Post -- cgit v1.2.3 From 24f381231412bec79fceb4385830bb39834061df Mon Sep 17 00:00:00 2001 From: Taylor Dolezal Date: Wed, 26 Jun 2019 12:14:36 -0700 Subject: Specify website repo Co-Authored-By: Aaron Crickenberger --- sig-docs/blog-subproject/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index 25d44fc5..95257d25 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -22,7 +22,7 @@ Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone]( - Slack: [#kubernetes-docs-blog](https://kubernetes.slack.com/messages/CJDHVD54J) - Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) -- Open Community Issues/PRs: `area/blog` label +- Open Community Issues/PRs: [`is:open repo:kubernetes/website label:area/blog`] (https://github.com/issues?q=is%3Aopen+label%3Aarea%2Fblog+repo%3Akubernetes%2Fwebsite) - GitHub Teams: [kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog), [kubernetes-blog-maintainers](https://github.com/orgs/kubernetes/teams/kubernetes-blog-maintainers) ## Submit a Post -- cgit v1.2.3 From 5ad5025259558487533f7b742f91409f7eb878f0 Mon Sep 17 00:00:00 2001 From: Taylor Dolezal Date: Wed, 26 Jun 2019 12:14:58 -0700 Subject: Specify Kubernetes organization Co-Authored-By: Aaron Crickenberger --- sig-docs/blog-subproject/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index 95257d25..db296c8b 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -23,7 +23,7 @@ Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone]( - Slack: [#kubernetes-docs-blog](https://kubernetes.slack.com/messages/CJDHVD54J) - Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) - Open Community Issues/PRs: [`is:open repo:kubernetes/website label:area/blog`] (https://github.com/issues?q=is%3Aopen+label%3Aarea%2Fblog+repo%3Akubernetes%2Fwebsite) -- GitHub Teams: [kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog), [kubernetes-blog-maintainers](https://github.com/orgs/kubernetes/teams/kubernetes-blog-maintainers) +- GitHub Teams: [@kubernetes/kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog), [@kubernetes/kubernetes-blog-maintainers](https://github.com/orgs/kubernetes/teams/kubernetes-blog-maintainers) ## Submit a Post -- cgit v1.2.3 From b53b7fe636c2706e9e9c2c9ea12e49ce7497c992 Mon Sep 17 00:00:00 2001 From: "Taylor.J.Dolezal" Date: Thu, 27 Jun 2019 15:47:51 -0700 Subject: Fix link for issues/PRs --- sig-docs/blog-subproject/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'sig-docs') diff --git a/sig-docs/blog-subproject/README.md b/sig-docs/blog-subproject/README.md index db296c8b..6978ed1e 100644 --- a/sig-docs/blog-subproject/README.md +++ b/sig-docs/blog-subproject/README.md @@ -22,7 +22,7 @@ Regular Blog Meeting: Tuesdays at 18:30 UTC (biweekly). [Convert Your Timezone]( - Slack: [#kubernetes-docs-blog](https://kubernetes.slack.com/messages/CJDHVD54J) - Mailing List: [blog@kubernetes.io](mailto:blog@kubernetes.io) -- Open Community Issues/PRs: [`is:open repo:kubernetes/website label:area/blog`] (https://github.com/issues?q=is%3Aopen+label%3Aarea%2Fblog+repo%3Akubernetes%2Fwebsite) +- Open Community Issues/PRs: [`is:open repo:kubernetes/website label:area/blog`](https://github.com/issues?q=is%3Aopen+label%3Aarea%2Fblog+repo%3Akubernetes%2Fwebsite) - GitHub Teams: [@kubernetes/kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog), [@kubernetes/kubernetes-blog-maintainers](https://github.com/orgs/kubernetes/teams/kubernetes-blog-maintainers) ## Submit a Post -- cgit v1.2.3 From e23ff8f7f8d6e293be871052594a596f92d3ef98 Mon Sep 17 00:00:00 2001 From: Nikhita Raghunath Date: Tue, 30 Jul 2019 19:29:38 +0530 Subject: Properly capitalize GitHub usernames --- sig-docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'sig-docs') diff --git a/sig-docs/README.md b/sig-docs/README.md index 2195ea14..a72b6270 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -25,7 +25,7 @@ The [charter](charter.md) defines the scope and governance of the Docs Special I ### Chairs The Chairs of the SIG run operations and processes governing the SIG. -* Jennifer Rondeau (**[@bradamant3](https://github.com/bradamant3)**), Stripe +* Jennifer Rondeau (**[@Bradamant3](https://github.com/Bradamant3)**), Stripe * Jared Bhatti (**[@jaredbhatti](https://github.com/jaredbhatti)**), Google * Zach Corleissen (**[@zacharysarah](https://github.com/zacharysarah)**), Linux Foundation -- cgit v1.2.3 From 4eec9f39d6912ac84fe89ee964f6a4d84d2a703f Mon Sep 17 00:00:00 2001 From: Aaron Crickenberger Date: Thu, 8 Aug 2019 12:52:27 -0700 Subject: Run make to use new generator templates --- sig-docs/README.md | 64 +++++++++++++++++++++++++----------------------------- 1 file changed, 29 insertions(+), 35 deletions(-) (limited to 'sig-docs') diff --git a/sig-docs/README.md b/sig-docs/README.md index a72b6270..09ca2b5b 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -34,44 +34,38 @@ The Chairs of the SIG run operations and processes governing the SIG. * Andrew Chen (**[@chenopis](https://github.com/chenopis)**), Google ## Contact -* [Slack](https://kubernetes.slack.com/messages/sig-docs) -* [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) -* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2Fdocs) +- Slack: [#sig-docs](https://kubernetes.slack.com/messages/sig-docs) +- [Mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) +- [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2Fdocs) +- GitHub Teams: + - [@kubernetes/kubernetes-blog](https://github.com/orgs/kubernetes/teams/kubernetes-blog) - Kubernetes blog maintainers + - [@kubernetes/sig-docs-de-owners](https://github.com/orgs/kubernetes/teams/sig-docs-de-owners) - German language content + - [@kubernetes/sig-docs-en-owners](https://github.com/orgs/kubernetes/teams/sig-docs-en-owners) - English content (default) + - [@kubernetes/sig-docs-es-owners](https://github.com/orgs/kubernetes/teams/sig-docs-es-owners) - Spanish language content + - [@kubernetes/sig-docs-fr-owners](https://github.com/orgs/kubernetes/teams/sig-docs-fr-owners) - French language content + - [@kubernetes/sig-docs-id-owners](https://github.com/orgs/kubernetes/teams/sig-docs-id-owners) - Indonesian language content + - [@kubernetes/sig-docs-it-owners](https://github.com/orgs/kubernetes/teams/sig-docs-it-owners) - Italian language content + - [@kubernetes/sig-docs-ja-owners](https://github.com/orgs/kubernetes/teams/sig-docs-ja-owners) - Japanese language content + - [@kubernetes/sig-docs-ko-owners](https://github.com/orgs/kubernetes/teams/sig-docs-ko-owners) - Korean language content + - [@kubernetes/sig-docs-maintainers](https://github.com/orgs/kubernetes/teams/sig-docs-maintainers) - Documentation maintainers + - [@kubernetes/sig-docs-pr-reviews](https://github.com/orgs/kubernetes/teams/sig-docs-pr-reviews) - Documentation PR reviews + - [@kubernetes/sig-docs-pt-owners](https://github.com/orgs/kubernetes/teams/sig-docs-pt-owners) - Portuguese language content + - [@kubernetes/sig-docs-zh-owners](https://github.com/orgs/kubernetes/teams/sig-docs-zh-owners) - Chinese language content ## Subprojects -The following subprojects are owned by sig-docs: -- **kubernetes-blog** - - Owners: - - https://raw.githubusercontent.com/kubernetes/website/master/content/en/blog/OWNERS -- **reference-docs** - - Owners: - - https://raw.githubusercontent.com/kubernetes-incubator/reference-docs/master/OWNERS -- **website** - - Owners: - - https://raw.githubusercontent.com/kubernetes/website/master/OWNERS - -## 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 | -| --------- |:-------:| ----------- | -| @kubernetes/kubernetes-blog | [link](https://github.com/orgs/kubernetes/teams/kubernetes-blog) | Kubernetes blog maintainers | -| @kubernetes/sig-docs-de-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-de-owners) | German language content | -| @kubernetes/sig-docs-en-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-en-owners) | English content (default) | -| @kubernetes/sig-docs-es-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-es-owners) | Spanish language content | -| @kubernetes/sig-docs-fr-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-fr-owners) | French language content | -| @kubernetes/sig-docs-id-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-id-owners) | Indonesian language content | -| @kubernetes/sig-docs-it-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-it-owners) | Italian language content | -| @kubernetes/sig-docs-ja-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ja-owners) | Japanese language content | -| @kubernetes/sig-docs-ko-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-ko-owners) | Korean language content | -| @kubernetes/sig-docs-maintainers | [link](https://github.com/orgs/kubernetes/teams/sig-docs-maintainers) | Documentation maintainers | -| @kubernetes/sig-docs-pr-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-docs-pr-reviews) | Documentation PR reviews | -| @kubernetes/sig-docs-pt-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-pt-owners) | Portuguese language content | -| @kubernetes/sig-docs-zh-owners | [link](https://github.com/orgs/kubernetes/teams/sig-docs-zh-owners) | Chinese language content | - +The following [subprojects][subproject-definition] are owned by sig-docs: +### kubernetes-blog +- **Owners:** + - https://raw.githubusercontent.com/kubernetes/website/master/content/en/blog/OWNERS +### reference-docs +- **Owners:** + - https://raw.githubusercontent.com/kubernetes-incubator/reference-docs/master/OWNERS +### website +- **Owners:** + - https://raw.githubusercontent.com/kubernetes/website/master/OWNERS + +[subproject-definition]: https://github.com/kubernetes/community/blob/master/governance.md#subprojects ## Goals * Discuss documentation and docs issues for kubernetes.io -- cgit v1.2.3 From bbc84db542c4ec65d5bc5dc47a60271d97aaeabe Mon Sep 17 00:00:00 2001 From: June Yi Date: Sat, 24 Aug 2019 10:39:01 +0900 Subject: Add SIG Docs Korean team meeting schedule --- sig-docs/README.md | 3 +++ 1 file changed, 3 insertions(+) (limited to 'sig-docs') diff --git a/sig-docs/README.md b/sig-docs/README.md index 09ca2b5b..4c798c18 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -16,6 +16,9 @@ The [charter](charter.md) defines the scope and governance of the Docs Special I * APAC SIG Meeting: [Wednesdays at 02:00 UTC](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit) (monthly - fourth Wednesday every month). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=02:00&tz=UTC). * [Meeting notes and Agenda](https://docs.google.com/document/d/1Ds87eRiNZeXwRBEbFr6Z7ukjbTow5RQcNZLaSvWWQsE/edit). * [Meeting recordings](https://www.youtube.com/playlist?list=PL69nYSiGNLP3b5hlx0YV7Lo7DtckM84y8). +* Korean Team Meeting: [Thursdays at 13:00 UTC](https://docs.google.com/document/d/1h5sMhBpPB5unJmBAS7KzDiPs-_eFQOu5o4UyHwMtFCA/edit) (biweekly). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=13:00&tz=UTC). + * [Meeting notes and Agenda](https://docs.google.com/document/d/1h5sMhBpPB5unJmBAS7KzDiPs-_eFQOu5o4UyHwMtFCA/edit). + * [Meeting recordings](https://www.youtube.com/playlist?list=PLAOP7m08QDCWZ7RwGca6cU4vzrOMw3ht7). * Regular SIG Meeting: [Tuesdays at 17:30 UTC](https://docs.google.com/document/d/1zg6By77SGg90EVUrhDIhopjZlSDg2jCebU-Ks9cYx0w/edit) (weekly - except fourth Tuesday every month). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=17:30&tz=UTC). * [Meeting notes and Agenda](https://docs.google.com/document/d/1Ds87eRiNZeXwRBEbFr6Z7ukjbTow5RQcNZLaSvWWQsE/edit). * [Meeting recordings](https://www.youtube.com/playlist?list=PL69nYSiGNLP3b5hlx0YV7Lo7DtckM84y8). -- cgit v1.2.3 From 6af9b58e631f74ee45fb6a5172ac9ff554f61c12 Mon Sep 17 00:00:00 2001 From: zacharysarah Date: Wed, 21 Aug 2019 14:35:16 -0700 Subject: Update SIG Docs leads Update sigs.yaml and make generate --- sig-docs/README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'sig-docs') diff --git a/sig-docs/README.md b/sig-docs/README.md index 4c798c18..2c60e230 100644 --- a/sig-docs/README.md +++ b/sig-docs/README.md @@ -29,12 +29,13 @@ The [charter](charter.md) defines the scope and governance of the Docs Special I The Chairs of the SIG run operations and processes governing the SIG. * Jennifer Rondeau (**[@Bradamant3](https://github.com/Bradamant3)**), Stripe -* Jared Bhatti (**[@jaredbhatti](https://github.com/jaredbhatti)**), Google +* Jim Angel (**[@jimangel](https://github.com/jimangel)**), General Motors * Zach Corleissen (**[@zacharysarah](https://github.com/zacharysarah)**), Linux Foundation ## Emeritus Leads * Andrew Chen (**[@chenopis](https://github.com/chenopis)**), Google +* Jared Bhatti (**[@jaredbhatti](https://github.com/jaredbhatti)**), Google ## Contact - Slack: [#sig-docs](https://kubernetes.slack.com/messages/sig-docs) -- cgit v1.2.3 From e661d98cf1aa1196cb9370baed84cc93b1aca574 Mon Sep 17 00:00:00 2001 From: Aimee Ukasick Date: Wed, 18 Sep 2019 13:59:58 -0500 Subject: Add 2019 SIG Docs survey explanation and results Signed-off-by: Aimee Ukasick --- sig-docs/survey/2019SIGDocsSurveyRaw.ods | Bin 0 -> 43891 bytes sig-docs/survey/2019SIGDocsSurveyResultsCharts.pdf | Bin 0 -> 150974 bytes sig-docs/survey/2019SeptSurvey.md | 140 +++++++++++++++++++++ 3 files changed, 140 insertions(+) create mode 100644 sig-docs/survey/2019SIGDocsSurveyRaw.ods create mode 100644 sig-docs/survey/2019SIGDocsSurveyResultsCharts.pdf create mode 100644 sig-docs/survey/2019SeptSurvey.md (limited to 'sig-docs') diff --git a/sig-docs/survey/2019SIGDocsSurveyRaw.ods b/sig-docs/survey/2019SIGDocsSurveyRaw.ods new file mode 100644 index 00000000..1449dad8 Binary files /dev/null and b/sig-docs/survey/2019SIGDocsSurveyRaw.ods differ diff --git a/sig-docs/survey/2019SIGDocsSurveyResultsCharts.pdf b/sig-docs/survey/2019SIGDocsSurveyResultsCharts.pdf new file mode 100644 index 00000000..05dd01c4 Binary files /dev/null and b/sig-docs/survey/2019SIGDocsSurveyResultsCharts.pdf differ diff --git a/sig-docs/survey/2019SeptSurvey.md b/sig-docs/survey/2019SeptSurvey.md new file mode 100644 index 00000000..6ba371f5 --- /dev/null +++ b/sig-docs/survey/2019SeptSurvey.md @@ -0,0 +1,140 @@ +| Data | Info | +| --- | --- | +Title | Kubernetes SIG Docs Survey 2019 +Authors | @aimeeu, @zacharysarah, @sftim with input from additional SIG Docs members (see [SIG-Docs: Documentation User Survey 2019](https://github.com/kubernetes/website/issues/15828)) +Tool Used | SurveyMonkey; @aimeeu worked with the CNCF to create the survey and obtain exported results +Start | 4 September 2019 +End | 7 September 2019 +Langauage | English +Data Processing | This survey did not ask for personal identifiers. Respondent's IP addresses have been removed from results. +Files | Presentation (2019SIGDocsSurveyResultsCharts.pdf) and raw results (2019SIGDocsSurveyRaw.ods) + + +### Questions + +1. What is your level of experience using Kubernetes? + - Beginner + - Experienced + - Expert +2. How do you use Kubernetes? + - Developer + - Administrator + - Developer and Administrator + - Other (please specify) +3. How do you usually access the Kubernetes documentation site most often? + - Phone + - Tablet + - Desktop +4. How long have you been using the Kubernetes documentation? + - Less than 6 months + - 6-12 months + - More than 12 months +5. In which languages do you read the Kubernetes documentation? + - German (de) + - English (en) + - Spanish (es) + - French (fr) + - Japanese (ja) + - Korean (ko) + - Portuguese (pt) + - Chinese (zh) +6. Is the Kubernetes documentation the first place you look for information about Kubernetes? + - Yes + - No +7. How easy is it to find content using the site’s navigation (top and left)? + - Not at all easy + - Slightly easy + - Moderately easy + - Very easy + - Extremely easy +8. How often do you use the search functionality to find content? + - Never + - Rarely + - Occasionally + - Every visit + - Several times per visit +9. Why do you access the Kubernetes documentation? Check all that apply. + - Installation for learning + - Installation for production + - Architecture + - Concepts + - Terminology (glossary) + - API reference + - kubectl CLI reference + - Tasks (administering a cluster, configuring pods, securing Kubernetes, upgrading, etc) + - Troubleshooting guidance + - Tutorials +10. How often do you find what you are looking for? + - Never + - Rarely + - Occasionally + - Most visits + - Every visit +11. Concepts: How satisfied are you with the level of detail in the Concepts section? + - Not at all satisfied + - Slightly satisfied + - Moderately satisfied + - Very satisfied + - Extremely satisfied +12. Concepts: How often do you find outdated content in the Concepts section? + - Never + - Rarely + - Occasionally + - Every visit + - Several times per visit +13. Concepts: How can we improve the Concepts section? Please select all that apply. + - More diagrams + - More example code + - More detailed content + - Other (please specify) +14. Tasks: How satisfied are you with the level of detail in the Tasks section? + - Not at all satisfied + - Slightly satisfied + - Moderately satisfied + - Very satisfied + - Extremely satisfied +15. Tasks: How often do you find outdated content in the Tasks section? + - Never + - Rarely + - Occasionally + - Every visit + - Several times per visit +16. Tasks: How can we improve the Tasks section? Please select all that apply. + - More diagrams + - More example code + - More detailed content + - Other (please specify) +17. Reference: How satisfied are you with the level of detail in the Reference section? + - Not at all satisfied + - Slightly satisfied + - Moderately satisfied + - Very satisfied + - Extremely satisfied +18. Reference: How often do you find outdated content in the Reference section? + - Never + - Rarely + - Occasionally + - Every visit + - Several times per visit +19. Reference: How can we improve the Reference section? Please select all that apply. + - More example code + - More detailed content + - Other (please specify) +20. Tutorials: How satisfied are you with the level of detail in the Tutorials section? + - Not at all satisfied + - Slightly satisfied + - Moderately satisfied + - Very satisfied + - Extremely satisfied +21. Tutorials: How often do you find outdated content in the Tutorials section? Please select all that apply. + - Never + - Rarely + - Occasionally + - Every visit + - Several times per visit +22. Tutorials: How can we improve the Tutorials section? Please select all that apply. + - Advanced tutorials (security, networking, configuration, troubleshooting, etc) + - Developer-oriented content + - The availability of interactive tutorials needs to be fixed + - Other (please specify) +23. How can we improve the Kubernetes documentation? -- cgit v1.2.3