Commit Graph

124 Commits

Author SHA1 Message Date
Kubernetes Prow Robot 89d1fe2bd2
Merge pull request #6536 from Riaankl/update-conformance-tests.md
update conformance-tests.md
2022-04-03 15:26:09 -07:00
Riaan Kleinhans 7ebe82693f
Update conformance-tests.md 2022-03-31 06:35:46 +13:00
David Eads 9a4dbd3878 Remove recommendation for condition heartbeat
Heartbeats previously caused significant standing load, they are not
recommended for API types.
2022-03-23 08:51:01 -04:00
Kubernetes Prow Robot 94ed8aaed7
Merge pull request #6541 from deads2k/api-off-by-default
add details for testing beta APIs now that they are off by default
2022-03-17 15:30:42 -07:00
David Eads d1c12d11d4 clarify how to name kubernetes label and annotation keys 2022-03-16 16:26:36 -04:00
David Eads 6bf340de5f add details for testing beta APIs now that they are off by default 2022-03-16 11:05:44 -04:00
Riaan Kleinhans 41e37715de
update conformance-tests.md 2022-03-14 14:26:37 +13:00
yuyang f1cd9abe6d fixed a tiny typo error 2022-03-10 11:23:07 +08:00
Elana Hashman f8148d406c
Note when PUT can create items
See https://github.com/kubernetes/community/issues/6041#issuecomment-1021176213
2022-01-25 11:44:36 -08:00
Tim Hockin b20f6135ee
Loosen the meaning of status in API conventions (#5842)
* Loosen the meaning of status in API conventions

As per KEP https://github.com/kubernetes/enhancements/issues/2527 -
remove the "from observation" guidance and add some discussion of when
to use status fields vs. additional types for allocated resources.

* Backtick spec and status

* Act on feedback
2022-01-10 14:42:25 -08:00
Kubernetes Prow Robot f058d9c79c
Merge pull request #5723 from Jefftree/default
Add default tag to api conventions
2022-01-10 10:33:12 -08:00
Madhav Jivrajani 1a8b4eb0c0 devel: fix/update links in api_changes.md
Signed-off-by: Madhav Jivrajani <madhav.jiv@gmail.com>
2022-01-06 11:09:28 +05:30
Ayushman 737df3cb8d
Changed all instances of k-dev@ and kubernetes-dev@ to dev@kubernetes.io (#6311)
* Changed all instancesof k-dev@ and kubernetes-dev@ to dev@kubernetes.io

Changes Removed From archive

updated the link

changes made

csv undo

changed links

* Fix last two instances of googlegroups.com

* Revert changes to election docs for past elections

Co-authored-by: Christoph Blecker <admin@toph.ca>
2022-01-04 21:36:32 -08:00
Claudiu Belu a48453ebf6 Removes [Exclude:WindowsDocker] test tag
We've removed support for Windows Docker in Kubernetes v1.24, so
we no longer need this tag.

Updates a few of the Windows tests considerations, since a few of them
are supported by Windows Containerd
2021-11-16 08:55:15 -08:00
Elana Hashman 8076461701
Document expectations of feature gate use per PRR 2021-11-18 08:48:15 -08:00
Chris Negus 4f95b92105
Add note to api conventions about kind: List (#5903)
* Add note to api conventions about kind: List

* Wording change

* Fixed small typo
2021-10-12 11:32:33 -07:00
Kubernetes Prow Robot 91bc44bf75
Merge pull request #5973 from robscott/kind-vs-resource-refs
Clarifying API Conventions regarding Kind and Resource in object refs
2021-09-14 06:27:09 -07:00
Jefftree 3a97f34b4b Add default tag to api conventions 2021-09-13 10:58:32 -07:00
Tim Hockin faebec1acf Update API pluralization docs
Based on Service ClusterIPs pluralization.
2021-09-10 16:03:09 -07:00
Khaled (Kal) Henidak 99780a63a6 add auto resource release 2021-09-07 18:40:57 +00:00
Rob Scott 83877032b5
Clarifying API Conventions regarding Kind and Resource in object refs 2021-09-01 15:22:29 -07:00
SataQiu 51b267d7a4 remove bazel build 2021-07-25 16:35:42 +08:00
Kubernetes Prow Robot f9798eb69c
Merge pull request #5869 from msau42/update-api-docs
Update steps on how to make a new API version
2021-07-16 05:16:09 -07:00
Michelle Au 0c8bda6665 Update steps on how to make a new API version and add guidance around structuring commits for API promotions 2021-07-15 18:10:40 -07:00
Kubernetes Prow Robot a843caa9b1
Merge pull request #5832 from toumorokoshi/feature/consolidate-object-reference-guidance
consolidate object ref guidance in api conventions
2021-07-09 10:54:53 -07:00
Yusuke Tsutsumi 00d73216d3 consolidate object ref guidance in api conventions
API conventions had two semi-duplicated sections for
object references, with slightly different guidance.

Consolidating guidance to point to the most recent
guidance.

Clarifying the naming recommendations for naming of lists
of object references, as the guidance was not explicit.
2021-06-18 13:46:40 -07:00
Kubernetes Prow Robot 1cc043a0b8
Merge pull request #5825 from dims/add-guidance-on-SHA-vs-tags-in-dependencies
Add guidance on SHA vs tags in dependencies
2021-06-16 09:20:00 -07:00
Kubernetes Prow Robot e519a8ba75
Merge pull request #5630 from kikisdeliveryservice/feature-gates-doc
sig-arch: Working with feature gates doc
2021-06-14 18:58:00 -07:00
Davanum Srinivas 1445c6177a
Apply suggestions from code review
Co-authored-by: Shamsher Ansari <shaansar@redhat.com>
2021-06-13 17:56:42 -04:00
Davanum Srinivas c7d7335957
Add guidance on SHA vs tags in dependencies
Signed-off-by: Davanum Srinivas <davanum@gmail.com>
2021-06-10 14:37:33 -04:00
Yusuke Tsutsumi 744e270f33 Apply suggestions from code review
Co-authored-by: Jordan Liggitt <jordan@liggitt.net>
2021-06-03 22:44:36 -07:00
Yusuke Tsutsumi 1df12ac90f Adding object references security considerations
Clarifying practices around object references that help
prevent against privilege escalation.
2021-06-03 22:44:36 -07:00
Kubernetes Prow Robot 1aed2f6904
Merge pull request #5782 from alculquicondor/patch-1
Explain use of feature labels for alpha and beta releases
2021-06-01 10:43:51 -07:00
Aldo Culquicondor 545177d8db Add note to ensure tests run in presubmits 2021-06-01 10:53:39 -04:00
Yusuke Tsutsumi ac7999cb51 Addressing comments
including blurb recommending using multi resource object references
if there is a chance it will be used that way.
2021-05-25 22:32:35 -07:00
Yusuke Tsutsumi bda0f5062e Addressing feeedback
- new section around resources with different versions
- called out edge cases around resource not found
- removed very old todo
2021-05-24 21:51:07 -07:00
Yusuke Tsutsumi 9b694b1b79 Update contributors/devel/sig-architecture/api-conventions.md
Co-authored-by: Daniel Smith <dbsmith@google.com>
2021-05-24 21:51:07 -07:00
Yusuke Tsutsumi fed5c1e6a6 Addressing feedback
- switching fieldpath syntax to reference best practices already in the
spec
- clarifying naming of the object reference field
- fixing a poor example with a kind used where a resource value should
have been.
2021-05-24 21:51:07 -07:00
Yusuke Tsutsumi e5fb87eafa addressing comments
- switched from kind to resource.
- extended examples to four kinds of object references.
- clarified use of JSON Pointer to determine the path to the field.
2021-05-24 21:51:07 -07:00
Yusuke Tsutsumi b1f8f5975c clarifying schema for multi-kind object references
There are a few types of patterns for multi-kind object references
that are currently included in the Kubernetes core resources
(EnvVarSource, ObjectReference).

Adding a section to clarify the preferred pattern for future
resources.
2021-05-24 21:51:07 -07:00
Kubernetes Prow Robot bffe980b66
Merge pull request #5470 from ccouzens/patch-1
API conventions: escape back-quotes when visible
2021-05-10 04:24:51 -07:00
Antoine Pelisse 27e1a81029 Include documentation for listTypes in api conventions 2021-04-05 15:42:41 -07:00
Kirsten Garrison 8828f0e589 update and refine feature-gates.md 2021-03-21 17:15:00 -07:00
Davanum Srinivas 544dc8c691 Update contributors/devel/sig-architecture/feature-gates.md
Co-authored-by: Elana Hashman <ehashman@users.noreply.github.com>
2021-03-13 17:45:22 -08:00
Davanum Srinivas 0d97e560fd Update contributors/devel/sig-architecture/feature-gates.md
Co-authored-by: Elana Hashman <ehashman@users.noreply.github.com>
2021-03-13 17:45:22 -08:00
Davanum Srinivas b6e823d655 Update contributors/devel/sig-architecture/feature-gates.md
Co-authored-by: Elana Hashman <ehashman@users.noreply.github.com>
2021-03-13 17:45:22 -08:00
Davanum Srinivas eb43242e29 Add a doc on how we work with feature gates
Signed-off-by: Davanum Srinivas <davanum@gmail.com>
2021-03-13 17:45:22 -08:00
Jordan Liggitt 2e9f1ea2f0 Address comments 2021-03-08 17:56:58 -05:00
Jordan Liggitt 9fe0b4c7f9 Describe process for allowing a new enum value in an existing field 2021-03-06 17:01:58 -05:00
Riaan Kleinhans f8d9d7294a Update conformance promotion details round removal of bazel 2021-03-03 12:09:25 +13:00