-
Notifications
You must be signed in to change notification settings - Fork 5.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #4424 from jimangel/meeting-mins-archive
adding readme and past minutes
- Loading branch information
Showing
5 changed files
with
6,350 additions
and
0 deletions.
There are no files selected for viewing
314 changes: 314 additions & 0 deletions
314
sig-docs/meeting-notes-archive/2016_Weekly_Meeting_Minutes.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,314 @@ | ||
| **12/13/2016** | ||
|
|
||
| * 1.5 is out the door. Wooo. | ||
| * New site org in 1.5 | ||
| * Added to tasks, tutorials, and concepts | ||
| * Statefulset docs fell under concepts, tutorials, and tasks. | ||
| * We want to do this the same way going forward. | ||
| * Template issues :( | ||
| * Github issues with templates :( | ||
| * They update, we break. Markdown processor breaks the site. | ||
| * First update broke the site chrome. | ||
| * Current change breaks how we automate page titling. | ||
| * AI: | ||
| * Explore Moving to using netlify to stage the site? (Jessfraz, Ddonnelly) | ||
| * Fix Page title needs to be fixed. | ||
| * Explore fixing templating in github pages. | ||
| * Propose hiring a web-dev for the team. | ||
| * TOCs | ||
| * Some pages that have TOCs in flux (tools page, for example) | ||
| * Should figure out a standard for organizing these pages. | ||
| * Concepts (Ddonnelly) | ||
| * Tasks, Tutorials (Stevepe) | ||
| * Issues Triaging, Templates, Standards | ||
| * [https://github.com/kubernetes/kubernetes.github.io/pull/1860](https://github.com/kubernetes/kubernetes.github.io/pull/1860) (AI: jaredb, review) | ||
| * Jan 10th is issue triage day :) | ||
| * 1.5 RefDocs Update | ||
| * [https://github.com/kubernetes/kubernetes.github.io/pull/1818](https://github.com/kubernetes/kubernetes.github.io/pull/1818) | ||
| * Manually reviewing some content, verifying HTML content. | ||
| * Using Deploy preview to review. | ||
| * Mehdy wants to release a blog post around the work that he’s done. | ||
| * Versioning | ||
| * Some thoughts: | ||
| * Maintain a release branch for each release | ||
| * Stage using netlify | ||
| * Clarify the level of support for release branches | ||
| * Only 1.5 going forward | ||
| * Deprecation notices | ||
| * Going to land on the site. Devin will decide. | ||
|
|
||
| **11/28/2016** | ||
|
|
||
|
|
||
|
|
||
| * Meeting using Zoom | ||
| * 1.5 Launches (Ihor, Jared) | ||
| * Launch Process Updates | ||
| * Link to spreadsheet https://docs.google.com/spreadsheets/d/1g9JU-67ncE4MHMeKnmslm-JO_aKeltv2kg_Dd6VFmKs/edit#gid=0 | ||
| * License Updates (Jared) | ||
| * cla/linuxfoundation is required, google license is not. | ||
| * Associated PRs: | ||
| * [update LICENSE](https://github.com/kubernetes/kubernetes.github.io/pull/1763) | ||
| * [update footer](https://github.com/kubernetes/kubernetes.github.io/pull/1764) | ||
| * [update "how to contribute"](https://github.com/kubernetes/kubernetes.github.io/pull/1765) | ||
| * Style Guides (Steve) | ||
| * PRs checked in | ||
| * Old Templates deleted. Long live the new templates. | ||
| * In progress: Remove some content from README and editdocs, and blend it into the new contribution pages. | ||
| * Issues Triaging (Abby) | ||
| * PR coming soon | ||
| * 1/10 triage day! | ||
| * Kubernetes swag will be given | ||
| * Quickstart Discussion: Bill Prin | ||
| * Move getting started and creating a cluster content to “tasks” | ||
| * Revamp content, remove GKE “Hello Node” | ||
| * Jeff and Bill will come up with a more in depth proposal for next week. | ||
| * API Reference docs (Phillip) | ||
| * [docs.k8s.replicatingperfection.net](http://docs.k8s.replicatingperfection.net) | ||
| * Questions? | ||
| * Need folks to review API Docs | ||
| * Sync with Devin on bandwidth | ||
| * Soft launch for 1.5? | ||
|
|
||
| **11/15/2016** | ||
|
|
||
| Agenda: | ||
|
|
||
|
|
||
|
|
||
| * Site Updates | ||
| * Issue Triaging (Abby) | ||
| * [http://kubernetes.io/docs/contribute/](http://kubernetes.io/docs/contribute/) | ||
| * Should schedule issue-triaging day | ||
| * Steve suggests review-issue.md | ||
| * Reference Docs Update? (Phillip) | ||
| * Should have something in two weeks | ||
| * Will use the updated refdocs for 1.5 | ||
| * Style and Contributor Guides | ||
| * PRs ready | ||
| * Preparing for K8s 1.5 Release: [https://docs.google.com/spreadsheets/d/1PcAW-ZQnzlwEs59ygHdFA-72n6FUcGIc2lx4IeoXvco/edit?ts=57ced759#gid=110968752&vpid=A1](https://docs.google.com/spreadsheets/d/1PcAW-ZQnzlwEs59ygHdFA-72n6FUcGIc2lx4IeoXvco/edit?ts=57ced759#gid=110968752&vpid=A1) | ||
| * Dev Summit Feedback | ||
| * [Brainstormed Issues with Site](https://github.com/kubernetes/kubernetes.github.io/issues/1686) | ||
| * [UX issues ](https://docs.google.com/document/d/1BoF_wA7J6N-zuCUgwMMj27ngaj3e4T0YJhvTNwWiWj8/edit#heading=h.y2ttshn5nulr) | ||
| * [Brainstorm on Developer Onboarding](https://docs.google.com/document/d/19B2vcK6Y3xE3JO7sd4n6lPF0m9bBVZpNucvcR3MwEXA/edit) | ||
| * PR backlog | ||
|
|
||
| **10/25/2016** | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * Site Updates | ||
| * Issue Backlog | ||
| * Doc shared with the SIG docs group | ||
| * [https://docs.google.com/document/d/1j1A6sVW_t5RF_dlxIxpWVbAQeLUlzR1Z26zENBltRms/edit](https://docs.google.com/document/d/1j1A6sVW_t5RF_dlxIxpWVbAQeLUlzR1Z26zENBltRms/edit) | ||
| * Reference Docs Update | ||
| * Redirects on Github? | ||
| * API and CLI Docs updates | ||
| * [http://docs.k8s.replicatingperfection.net/](http://docs.k8s.replicatingperfection.net/) | ||
| * [http://kubectl.k8s.replicatingperfection.net/](http://kubectl.k8s.replicatingperfection.net/) | ||
| * Suggested task docs | ||
| * | ||
|
|
||
| **10/11/2016** | ||
|
|
||
| No meeting due to technical issues. | ||
|
|
||
| **9/27/2016** | ||
|
|
||
| Announcements | ||
|
|
||
|
|
||
|
|
||
| * 1.4 went live! Hoorays! | ||
| * Templates and new site layout went live! ([http://kubernetes.io/docs/](http://kubernetes.io/docs/)) | ||
| * Tons of work to do here. | ||
| * Bootcamp pages integrated into site: | ||
| * http://kubernetes.io/docs/tutorials/getting-started/create-cluster/ | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * Launch process for upcoming releases | ||
| * [Keep the spreadsheet](https://docs.google.com/spreadsheets/d/1PcAW-ZQnzlwEs59ygHdFA-72n6FUcGIc2lx4IeoXvco/edit?ts=57ced759#gid=0) | ||
| * Sync with [Community Spreadsheet](https://docs.google.com/spreadsheets/d/1MeTQbtSiTCoQ74zjEGRI1rXRSP0Tzmo9-kMJSK_HGoA/) | ||
| * Communicate out which branch to use | ||
| * Delete the version branch immediately after launch? (most people say yes) | ||
| * Number each branch | ||
| * Pointing to the “right” version of kubernetes: | ||
| * [https://groups.google.com/forum/#!topic/kubernetes-sig-docs/d5vB92b4HaI](https://groups.google.com/forum/#!topic/kubernetes-sig-docs/d5vB92b4HaI) | ||
| * Toolset with the documentation deploys 1.3 | ||
| * Please push to master :) | ||
| * Issues: | ||
| * PR template is in! | ||
| * Jeff Menoza needs to merge template with “create issue” button | ||
| * Proposal for issues will be out for review. | ||
|
|
||
| Kudos | ||
|
|
||
|
|
||
|
|
||
| * Phillip Wittrock | ||
| * Devin Donnelly | ||
|
|
||
| **9/20/2016** | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * 1.4 Delayed until next week ([1.4 Spreadsheet)](https://docs.google.com/spreadsheets/d/1PcAW-ZQnzlwEs59ygHdFA-72n6FUcGIc2lx4IeoXvco/edit?ts=57ced759#gid=0) | ||
| * [Doc Templates ](https://github.com/kubernetes/kubernetes.github.io/pull/1205) | ||
| * Any more feedback? | ||
| * Still adding canonical examples | ||
| * Outstanding questions for those TBD by jeffmendoza | ||
| * Bootcamp integrated into master ([pending PR](https://github.com/kubernetes/kubernetes.github.io/pull/1203)) | ||
| * Not using the templates | ||
| * Keeping the existing CSS | ||
| * Issue Template update? | ||
| * PR filed | ||
| * CLA isn’t approved. Weird. | ||
| * Is your github account under your company’s email? | ||
| * Next Steps: | ||
| * Submit PR | ||
| * AI: Develop proposal for handling backlog of issues (Abby) | ||
| * Run it by Frank for review | ||
| * Dead link report: | ||
| * AI: Regenerate the report, mark what will fixed in the upcoming release (1.4), focus on fixing manually generated content | ||
|
|
||
| Updates: | ||
|
|
||
|
|
||
|
|
||
| * New “edit docs” button at the bottom of the page | ||
| * Fix in for generating API and Kubectl docs (no more broken links! Won’t get in until 1.4). | ||
| * Kudos to Abby for creating the PR for issue templates | ||
|
|
||
| **9/13/2016** | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * Update on Netlify! (Devin) | ||
| * Dan Paik - new PM on Gcloud/K8s - will be working on cluster deployments, GKE UI, and PetSet deployments | ||
|
|
||
| Updates: | ||
|
|
||
|
|
||
|
|
||
| * “I wish” is gone. “File an issue” instead. (thanks Jeff!) | ||
| * Still need guidelines to close issues :) | ||
| * Status of issue templates and guidelines? (Abby?) | ||
| * Took a stab at [making an issue template](https://docs.google.com/document/d/1aZ6vlxOhNtKNhNOUx_KTUw1bXCPPRH2_TJsNRz7CA58/edit?ts=57d83501) (in Google Doc) | ||
| * Feedback: | ||
| * Keep existing title with URL | ||
| * Specify feature vs. bug (new doc vs. doc update) | ||
| * File a PR :) | ||
| * [1.4 Process](https://docs.google.com/spreadsheets/d/1PcAW-ZQnzlwEs59ygHdFA-72n6FUcGIc2lx4IeoXvco/edit?ts=57ced759#gid=0) | ||
| * [Templates ](https://github.com/kubernetes/kubernetes.github.io/pull/1205)(Steve) | ||
| * - Netlify | ||
| * [SEO Issues with K8s](https://docs.google.com/document/d/19A8GL7lNpvrVZJyPLHYgM7axcw6PWxT1yjQydno58L0/edit#heading=h.ucf6rfasc6ai) | ||
|
|
||
| **August 30, 2016** | ||
|
|
||
| Agenda: | ||
|
|
||
|
|
||
|
|
||
| * Customer Feedback: | ||
| * “I wish” | ||
| * Make an issue / Make an edit | ||
| * Remove the functionality, replace with make an issue/made edits | ||
| * AI: Jeff Mendoza | ||
| * Star ratings vs. Thumbs Up | ||
| * Issues :( | ||
| * 300 issues | ||
| * Write up a md file for issue guidelines? | ||
| * Issue templates? | ||
| * AI: Abby: | ||
| * Issue guidelines | ||
| * Issue template | ||
| * Close issues that don’t conform | ||
| * Steve chat [through new templates](https://github.com/kubernetes/kubernetes.github.io/tree/docsv2/_includes/templates). | ||
| * 1.4 Features and Publishing | ||
| * Alpha: [14 Open Issues](https://github.com/kubernetes/features/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aopen%20label%3Aalpha-in-1.4%20) | ||
| * Beta: [8 Open Issues](https://github.com/kubernetes/features/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aopen%20label%3Abeta-in-1.4%20) | ||
| * Stable: [5 Open Issues](https://github.com/kubernetes/features/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aopen%20label%3Astable-in-1.4%20) | ||
| * Publishing process? | ||
| * Current release branch | ||
| * Under development release | ||
| * Make a rule that any change in the current version has to be made in the “under development” version. | ||
|
|
||
| **August 23, 2016** | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * Introductions - New Members | ||
| * Jared, Abby (Apprenda), Frank Solomon (Blogger, SWE) | ||
| * Items from the past meeting: | ||
| * Third party docs? Process for moving them? Plan? | ||
| * [Issue in current UX Backlog](https://github.com/kubernetes/kubernetes/milestone/24) | ||
| * [Dead Link Report](https://docs.google.com/spreadsheets/d/1vLmdCSZngIRUtBcG04QGWSQ42Pr3198n-RMctq8Kv7I/edit#gid=969833937) | ||
| * If you have time please fix! | ||
| * Please keep the status up to date | ||
| * Kubernetes Bootcamp (Beta) | ||
| * [https://kubernetesbootcamp.github.io/kubernetes-bootcamp/](https://kubernetesbootcamp.github.io/kubernetes-bootcamp/) | ||
| * Please review if you have a chance | ||
|
|
||
| **August 16, 2016** | ||
|
|
||
| Kickoff Meeting! | ||
|
|
||
| Agenda | ||
|
|
||
|
|
||
|
|
||
| * Introductions - New Members | ||
| * Jared (TW, Manager), Phillip (SWE, UX), Devin (TW), Steve (TW), Josh (SWE), Dan Romlein (UX, Apprenda), Abby (TW, Apprenda), Sarah Novotny (Community), Janet (SWE, UX), Frank, Morgan (TW, IBM) | ||
| * Current state of the docs (Jared) | ||
| * John Mulhausen has left the group | ||
| * Devin and Steve are joining full time from Google | ||
| * We want to make things easier for users navigating the site, and contributors contributing to the site. | ||
| * Doc goals and doc plans (Devin) | ||
| * Building on John’s work, building new processes. | ||
| * Some findability and readability improvements in the short term. | ||
| * Significant problems with findability. | ||
| * Title != URL != Place in table of contents. | ||
| * Good content with some better organization | ||
| * For example: | ||
| * Glossary is a collection of “conceptual articles”. Should better explain the “kubernetes model” | ||
| * Also, a good place for new diagrams. | ||
| * Better guidance on audience. Explicitly state who our audience is: | ||
| * App Builders - Just running an application on top of K8s. Probably don’t want/need to know too much about what’s “under the hood” | ||
| * Container Maintainers/Builders - Want to know the deeper aspects of K8s. | ||
| * Build out the contributor | ||
| * Style Guide (titling docs, content fit into categories, tone and term usage to unify content and fix SEO) | ||
| * Templates - Build out | ||
| * Contribution process | ||
| * Questions: | ||
| * Third party docs? How do we build and maintain them? | ||
| * Proposal - that content should not live inside the core repo, since we can’t maintain it well. | ||
| * No objections to this proposal so far.... Need to have a way to separate this process out and find new homes for it. | ||
| * Need an owner for this process. | ||
|
|
||
| Additional Agenda Items? | ||
|
|
||
| * New contributor onboarding process (Phillip) | ||
| * **_Style guide (Josh)_** | ||
| * Initial tasks for new contributors | ||
| * Repo Issues list | ||
| * Github Issues that writers take on? | ||
| * Getting help | ||
| * Slack Channel (#sig-docs) for folks who need help or guidance. | ||
| * Feel free to ping | ||
| * To login to Zoom: Phillip directly. | ||
| * Diagrams - How should we create these? (Phillip) | ||
|
|
||
| Issues, suggestions, concerns, kudos? | ||
|
|
||
| * Kudos: Thanks to Phillip Wittrock and Kelsey Hightower for closing out our list of outstanding docs PRs |
Oops, something went wrong.