AKS Learn feedback: "Statically provision a volume" annotated with pv.kubernetes.io/provisioned-by

mloskot commented 4 days ago

Type of issue

Other (describe below)

Feedback

In the Statically provision a volume section there is this example, copied below, which displays use of pv.kubernetes.io/provisioned-by annotation:

apiVersion: v1
kind: PersistentVolume
metadata:
  annotations:
    pv.kubernetes.io/provisioned-by: file.csi.azure.com
  name: azurefile
spec:
  ...

while the Kubernetes documentation on Well-Known Labels, Annotations and Taints indicates this annotation should correspond to dynamic provisioning, screenshot with the section pasted below:

The lack of explanation on why the example uses the annotation makes the example confusing to reader.

Page URL

https://learn.microsoft.com/en-us/azure/aks/azure-csi-files-storage-provision#statically-provision-a-volume

Content source URL

https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/aks/azure-csi-files-storage-provision.md

Author

@tamram

Document Id

b95ca0b2-e809-a149-dec7-a15ac2146ee1

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

ID: bdb3a253-ff94-1b97-62c9-e21153598452
Version Independent ID: b95ca0b2-e809-a149-dec7-a15ac2146ee1
Content: Create a persistent volume with Azure Files in Azure Kubernetes Service (AKS) - Azure Kubernetes Service
Content Source: articles/aks/azure-csi-files-storage-provision.md
Service: azure-kubernetes-service
Sub-service: aks-storage
GitHub Login: @tamram
Microsoft Alias: tamram

TPavanBalaji commented 3 days ago

@mloskot Thanks for your feedback! We will investigate and update as appropriate.

SaibabaBalapur-MSFT commented 1 day ago

@mloskot I'm going to assign this to the document author so they can take a look at it accordingly.

@tamram Please review it.

MicrosoftDocs / azure-docs