Initial draft of SIG-Usability.

2019-06-14 11:13:06 -07:00 · 2019-06-14 11:13:06 -07:00 · f20e0105aa
parent bc5e6ead4a
commit f20e0105aa
5 changed files with 180 additions and 0 deletions
--- a/5
+++ b/5
@ -107,6 +107,11 @@ aliases:
    - floreks
    - jeefy
    - maciaszczykm
+  sig-usability-leads:
+    - Rajakavitha1
+    - hpandeycodeit
+    - tashimi
+    - vllry
  sig-vmware-leads:
    - cantbewong
    - frapposelli
--- a/sig-list.md
+++ b/sig-list.md
@ -49,6 +49,7 @@ When the need arises, a [new SIG can be created](sig-wg-lifecycle.md)
 |[Storage](sig-storage/README.md)|storage|* [Bradley Childs](https://github.com/childsb), Red Hat<br>* [Saad Ali](https://github.com/saad-ali), Google<br>|* [Slack](https://kubernetes.slack.com/messages/sig-storage)<br>* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-storage)|* Regular SIG Meeting: [Thursdays at 9:00 PT (Pacific Time) (biweekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>
 |[Testing](sig-testing/README.md)|testing|* [Erick Fejta](https://github.com/fejta), Google<br>* [Aaron Crickenberger](https://github.com/spiffxp), Google<br>* [Steve Kuznetsov](https://github.com/stevekuznetsov), Red Hat<br>* [Timothy St. Clair](https://github.com/timothysc), VMware<br>|* [Slack](https://kubernetes.slack.com/messages/sig-testing)<br>* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-testing)|* Regular SIG Meeting: [Tuesdays at 13:00 PT (Pacific Time) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>* (kind) sigs.k8s.io/kind bi-weekly meeting: [Mondays at 11:00 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>* (testing-commons) Testing Commons: [Fridays at 07:30 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>
 |[UI](sig-ui/README.md)|ui|* [Dan Romlein](https://github.com/danielromlein), Google<br>* [Sebastian Florek](https://github.com/floreks), Loodse<br>* [Jeffrey Sica](https://github.com/jeefy), University of Michigan<br>* [Marcin Maciaszczyk](https://github.com/maciaszczykm), Loodse<br>|* [Slack](https://kubernetes.slack.com/messages/sig-ui)<br>* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-ui)|* Regular SIG Meeting: [Thursdays at 09:00 PT (Pacific Time) (bi-weekly)](https://groups.google.com/forum/#!forum/kubernetes-sig-ui)<br>
+|[Usability](sig-usability/README.md)|usability|* [Rajakavitha Kodhandapani](https://github.com/Rajakavitha1), The Linux Foundation<br>* [Himanshu Pandey](https://github.com/hpandeycodeit), Pivotal?<br>* [Tasha Drew](https://github.com/tashimi), VMWare<br>* [Vallery Lancey](https://github.com/vllry), Lyft<br>|* [Slack](https://kubernetes.slack.com/messages/sig-usability)<br>* [Mailing List](TBD)|* Regular SIG Meeting: [TBDs at TBD PT (Pacific Time) (every third week)](tbd)<br>
 |[VMware](sig-vmware/README.md)|vmware|* [Steve Wong](https://github.com/cantbewong), VMware<br>* [Fabio Rapposelli](https://github.com/frapposelli), VMware<br>|* [Slack](https://kubernetes.slack.com/messages/sig-vmware)<br>* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-vmware)|* Regular SIG Meeting: [Thursdays at 11:00 PT (Pacific Time) (bi-weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>
 |[Windows](sig-windows/README.md)|windows|* [Michael Michael](https://github.com/michmike), VMware<br>* [Patrick Lang](https://github.com/patricklang), Microsoft<br>|* [Slack](https://kubernetes.slack.com/messages/sig-windows)<br>* [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-windows)|* Regular SIG Meeting: [Tuesdays at 12:30 Eastern Standard Time (EST) (weekly)](https://docs.google.com/document/d/1FQx0BPlkkl1Bn0c9ocVBxYIKojpmrS1CFP5h0DI68AE/edit)<br>

--- a/sig-usability/README.md
+++ b/sig-usability/README.md
@ -0,0 +1,51 @@
+<!---
+This is an autogenerated file!
+
+Please do not edit this file directly, but instead make changes to the
+sigs.yaml file in the project root.
+
+To understand how this file is generated, see https://git.k8s.io/community/generator/README.md
+--->
+# Usability Special Interest Group
+
+The scope of SIG usability is the core end-user usability of the Kubernetes project. This covers topics like user experience and accessibility. The goals of the SIG are to ensure that the Kubernetes project is maximally usable by users of a variety of different backgrounds and abilities. Examples of efforts include internationalization and accessibility of documentation.
+
+The [charter](charter.md) defines the scope and governance of the Usability Special Interest Group.
+
+## Meetings
+* Regular SIG Meeting: [TBDs at TBD PT (Pacific Time)](tbd) (every third week). [Convert to your timezone](http://www.thetimezoneconverter.com/?t=TBD&tz=PT%20%28Pacific%20Time%29).
+  * [Meeting notes and Agenda](tbd).
+  * [Meeting recordings](tbd).
+
+## Leadership
+
+### Chairs
+The Chairs of the SIG run operations and processes governing the SIG.
+
+* Rajakavitha Kodhandapani (**[@Rajakavitha1](https://github.com/Rajakavitha1)**), The Linux Foundation
+* Himanshu Pandey (**[@hpandeycodeit](https://github.com/hpandeycodeit)**), Pivotal?
+* Tasha Drew (**[@tashimi](https://github.com/tashimi)**), VMWare
+* Vallery Lancey (**[@vllry](https://github.com/vllry)**), Lyft
+
+## Contact
+* [Slack](https://kubernetes.slack.com/messages/sig-usability)
+* [Mailing list](TBD)
+* [Open Community Issues/PRs](https://github.com/kubernetes/community/labels/sig%2Fusability)
+
+## 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/sig-usability-api-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-usability-api-reviews) | API Changes and Reviews |
+| @kubernetes/sig-usability-bugs | [link](https://github.com/orgs/kubernetes/teams/sig-usability-bugs) | Bug Triage and Troubleshooting |
+| @kubernetes/sig-usability-feature-requests | [link](https://github.com/orgs/kubernetes/teams/sig-usability-feature-requests) | Feature Requests |
+| @kubernetes/sig-usability-misc | [link](https://github.com/orgs/kubernetes/teams/sig-usability-misc) | General Discussion |
+| @kubernetes/sig-usability-pr-reviews | [link](https://github.com/orgs/kubernetes/teams/sig-usability-pr-reviews) | PR Reviews |
+| @kubernetes/sig-usability-proposals | [link](https://github.com/orgs/kubernetes/teams/sig-usability-proposals) | Design Proposals |
+
+<!-- BEGIN CUSTOM CONTENT -->
+
+<!-- END CUSTOM CONTENT -->
--- a/sig-usability/charter.md
+++ b/sig-usability/charter.md
@ -0,0 +1,73 @@
+# SIG Usability Charter
+
+This charter adheres to the conventions described in the [Kubernetes Charter README] and uses
+the Roles and Organization Management outlined in [sig-governance].
+
+## Scope
+
+The scope of SIG usability is the core end-user usability of the Kubernetes project. This covers
+topics like user experience and accessibility. The goal of SIG Usability is to facilitate adoption of
+the Kubernetes project by as diverse a community of end users as possible. We do this be ensuring that
+each end user’s interaction with Kubernetes, from discovery to successful production use is seamless
+and positive. Examples of efforts include user research, internationalization and accessibility.
+
+### In scope
+
+#### Code, Binaries and Services
+
+- usability of end-user facing experiences (error messages, end-to-end tasks, etc)
+- accessibility guidelines for Kubernetes community artifacts, examples include:
+   - internationalization of documentation in binaries and documentation
+   - color choices for people with color blind-ness
+   - ensuring compatibility with screen reader technology
+- user interface design for core components with user interfaces.
+- code for performing internationaization and other accessbility enablement.
+- translations - https://github.com/kubernetes/kubernetes/tree/master/translations
+- internationalization - https://github.com/kubernetes/kubernetes/tree/master/pkg/kubectl/util/i18n
+
+#### Repos
+The SIG owns a `kubernetes/user-research` repo for the purpose of documenting:
+
+- Common end user profiles (aka personas)
+- Ongoing list of research studies and findings
+- Ongoing list of known needs for user research (ex: top stackoverflow questions)
+- Curated research on usability best practices (ex: HCI research literature on interface usability, error message best practices)
+- Templates for anybody to be able to conduct user research interviews
+
+#### Cross-cutting and Externally Facing Processes
+SIG Usability will facilitate and collaborate with other SIGs on:
+- giving end users channels for proving feedback on their experience
+- surveys and other feedback gathering around project usability
+- documenting common end user profiles (aka personas)
+- documenting common end user interactions with Kubernetes (aka user journeys)
+- design elements and language guidelines for Kubernetes concepts (e.g. 'reconciliation' or 'service')
+- identifying opportunities for user research and best methods to achieve (qualitative and quantitative).
+- tracking adherence to required guidelines such as (WCAG which is required to sell products in Europe.)[https://www.w3.org/WAI/news/2018-09-13/WCAG-21-EN301549/]
+- documentation in the vein of https://www.microsoft.com/en-us/accessibility/
+
+### Out of scope
+
+* Contributor user experience (covered by SIG-Contributor Experience)
+* API Design (covered by SIG-Architecture)
+* Command line tool infrastructure (covered by SIG-CLI)
+* How-to guides for implementing accessible documentation (covered by SIG-Docs)
+
+## Roles and Organization Management
+
+This sig follows adheres to the Roles and Organization Management outlined in [sig-governance]
+and opts-in to updates and modifications to [sig-governance].
+
+### Additional responsibilities of Chairs
+None
+
+### Deviations from [sig-governance]
+
+No Tech Leads (for now)
+
+### Subproject Creation
+
+Federation of Subprojects
+
+[sig-governance]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/sig-governance.md
+[sig-subprojects]: https://github.com/kubernetes/community/blob/master/sig-YOURSIG/README.md#subprojects
+[Kubernetes Charter README]: https://github.com/kubernetes/community/blob/master/committee-steering/governance/README.md
--- a/sigs.yaml
+++ b/sigs.yaml
@ -2256,6 +2256,56 @@ sigs:
    owners:
    - https://raw.githubusercontent.com/kubernetes-sigs/dashboard-metrics-scraper/master/OWNERS
    - https://raw.githubusercontent.com/kubernetes/dashboard/master/OWNERS
+- dir: sig-usability
+  name: Usability
+  mission_statement: >
+    The scope of SIG usability is the core end-user usability of the Kubernetes project.
+    This covers topics like user experience and accessibility. The goals of the SIG
+    are to ensure that the Kubernetes project is maximally usable by users of a variety
+    of different backgrounds and abilities. Examples of efforts include internationalization
+    and accessibility of documentation.
+
+  charter_link: charter.md
+  label: usability
+  leadership:
+    chairs:
+    - github: Rajakavitha1
+      name: Rajakavitha Kodhandapani
+      company: The Linux Foundation
+    - github: hpandeycodeit
+      name: Himanshu Pandey
+      company: Pivotal?
+    - github: tashimi
+      name: Tasha Drew
+      company: VMWare
+    - github: vllry
+      name: Vallery Lancey
+      company: Lyft
+  meetings:
+  - description: Regular SIG Meeting
+    day: TBD
+    time: TBD
+    tz: PT (Pacific Time)
+    frequency: every third week
+    url: tbd
+    archive_url: tbd
+    recordings_url: tbd
+  contact:
+    slack: sig-usability
+    mailing_list: TBD
+    teams:
+    - name: sig-usability-api-reviews
+      description: API Changes and Reviews
+    - name: sig-usability-bugs
+      description: Bug Triage and Troubleshooting
+    - name: sig-usability-feature-requests
+      description: Feature Requests
+    - name: sig-usability-misc
+      description: General Discussion
+    - name: sig-usability-pr-reviews
+      description: PR Reviews
+    - name: sig-usability-proposals
+      description: Design Proposals
 - dir: sig-vmware
  name: VMware
  mission_statement: >