website/content/en/docs/concepts/storage
Anton Gilgur 74ee1d9875
docs(storage-classes): add section on default `StorageClass` (#41843)
* docs(storage-classes): add section on default StorageClass

- empty commit at the beginning for the squash
  - PR template asks the first commit to be named appropriately for squashes

* Update storage-classes.md

Add Note at the end about having a single default storage class is preferred and that Kubernetes does not prevent you from having multiple storage classes.

* Updated storage-classed.md

Updated storage-classed.md based on feedback.

* update storage-class.md

Updated storage-class.md based on feedback

* fix feedback and grammar

- consistently use StorageClass, as that's how it's mostly used in this doc and the PVC doc
  - except when it is plural, in that case "storage classes" is used
  - fix docs reference to use the proper title of the doc too, which also has it as one word
- consolidate two sentences together that both describe what a default StorageClass is for
  - `storageClassName` is the specific PVC field; use backticks and camelCase when describing it
- remove extra new line

- minor grammar and spacing fixes
  - more than one space was occassionally used
  - a cloud provider will similarly only ever set _one_ default StorageClass, so use singular instead of plural

* docs(storage-classes): add section on default StorageClass

- the PVC docs reference this and there is an administrator guide on how to change this, but no section within the central Storage Classes document
  - this has made it a bit difficult to explain how that a default StorageClass exists as the StorageClass docs themselves barely mention it
  - with a new section, this makes it very clear and links out to other existing docs on the topic

- based off a previous PR that went through some review cycles and added this section but was never merged

* update what happens when multiple defaults exist

- c.f. 962235c86a (diff-77fd84defc818b9e6010794bf87e0eece0960dfeff196e19b7d84da8de15ddffR67)
  - chooses the newest by default

* slight modifications according to the style guide

- simplify dynamic provisionining reference
  - it's specific, but very accurate, so I'm hesitant to remove more pieces of it

- simplify tense; this is still a "hypothetical" (if/when) scenario, so still not present tense, but simpler past perfect tense instead of future perfect tense
  - futher modifications welcome!

* use a relative path to the doc instead of a URL

Co-authored-by: Rey Lejano <rlejano@gmail.com>

---------

Co-authored-by: Ju Lim (Red Hat) <julim@redhat.com>
Co-authored-by: Rey Lejano <rlejano@gmail.com>
2023-07-05 21:55:03 -07:00
..
_index.md Remove exec permission on markdown files 2021-06-16 17:57:00 +08:00
dynamic-provisioning.md Optimize link target in /dynamic-provisioning.md 2022-11-04 09:51:15 +08:00
ephemeral-volumes.md KEP-596: Move CSIInlineVolume to GA 2022-07-28 09:31:37 -06:00
persistent-volumes.md Update ReadWriteOncePod feature to beta 2023-03-14 13:52:52 -07:00
projected-volumes.md Merge pull request #37791 from Pradumnasaraf/Update-projected-volumes 2022-11-13 18:31:56 -08:00
storage-capacity.md KubeCon Docs Sprint: Update page weights for content/en/docs/concepts/storage. 2022-10-24 15:55:54 -04:00
storage-classes.md docs(storage-classes): add section on default `StorageClass` (#41843) 2023-07-05 21:55:03 -07:00
storage-limits.md KubeCon Docs Sprint: Update page weights for content/en/docs/concepts/storage. 2022-10-24 15:55:54 -04:00
volume-health-monitoring.md tweak line wrappings in storage/ 2023-06-01 21:20:18 +08:00
volume-pvc-datasource.md tweak line wrappings in storage/ 2023-06-01 21:20:18 +08:00
volume-snapshot-classes.md tweak line wrappings in storage/ 2023-06-01 21:20:18 +08:00
volume-snapshots.md Update volume mode change annotation in documentation 2023-02-09 11:25:13 +05:30
volumes.md Remove Docker volumes background reference 2023-05-19 11:22:25 -07:00
windows-storage.md Fix links about flexvolume 2022-11-01 15:38:12 +08:00