Address PR comments

Author: pwittrock

contributors/devel/api_changes.md

@@ -623,7 +623,7 @@ tips](../api.md#v1-conversion-tips))
 via a flag should not create new bugs in unrelated features; because the feature
 is new, it may have minor bugs
   - Support: the project commits to complete the feature, in some form, in a
-subsequent Stable version; beta features are required to remain in beta for
+subsequent Stable version; As a general guideline, beta features should remain in beta for
 2 releases after the feature has been introduced (GA development begins
 after the feature has been beta for 1 full release cycle).
 This provides time to gather user feedback before transitioning from beta to GA;

contributors/devel/contributing-api-changes.md

@@ -135,6 +135,8 @@ by users and is maintained in concert with related APIs.  Current API groups:
 
 - [API changes]
 - [API conventions]
+- [OARP roles model](https://stumblingabout.com/tag/oarp/)
+- [RACI roles model](http://www.valuebasedmanagement.net/methods_raci.html)
 
 [API versions]: https://github.com/kubernetes/community/blob/master/contributors/devel/api_changes.md#alpha-beta-and-stable-versions
 [@mention]: https://help.github.com/articles/basic-writing-and-formatting-syntax/#mentioning-users-and-teams

contributors/sig-ownership.md

@@ -46,12 +46,14 @@ Any changes that break compatibility with client-server version skew tests of +-
 
 ## Documentation
 
-All user facing changes must be documented at [kubernetes/kubernetes.github.io].  See the [doc contribution guide] for instructions.
+All user facing changes must be documented at [kubernetes/kubernetes.github.io] to
+appear in the [user docs].  See the [doc contribution guide] for instructions.
 
 [feature freeze]: https://github.com/kubernetes/community/blob/master/contributors/devel/release/README.md#feature-freeze
 [kubernetes/kubernetes.github.io]: https://github.com/kubernetes/kubernetes.github.io/
 [doc contribution guide]: https://kubernetes.io/editdocs/
 [special interest group]: https://github.com/kubernetes/community/blob/master/README.md#special-interest-groups-sig
 [kubernetes/kubernetes]: https://github.com/kubernetes/kubernetes
 [kubernetes/features]: https://github.com/kubernetes/features/
-[api review]: https://github.com/kubernetes/community/blob/master/contributors/contributing-api-changes.md
+[api review]: https://github.com/kubernetes/community/blob/master/contributors/contributing-api-changes.md
+[user docs]: https://k8s.io