Add kustomization and transformer references (#5523)

* Add fields to kustomization file ref

* Address grammar feedback.

* labels.fields

site/content/en/docs/Reference/API/Kustomization File/commonAnnotations.md

@@ -4,7 +4,18 @@ linkTitle: "commonAnnotations"
 type: docs
 weight: 3
 description: >
-    Add annotations to add all resources.
+    Add Annotations to all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`commonAnnotations`](/docs/tasks/labels_and_annotations/).
+See the [Tasks section] for examples of how to use `commonAnnotations`.
+
+### commonAnnotations
+Adds [Annotations] to all resources.
+
+* **commonAnnotations** (map[string]string)
+
+    Map of annotations to add to all resources.
+
+[Tasks section]: /docs/tasks/labels_and_annotations/
+[Annotations]: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/

site/content/en/docs/Reference/API/Kustomization File/commonLabels.md

@@ -4,7 +4,19 @@ linkTitle: "commonLabels"
 type: docs
 weight: 4
 description: >
-    Add labels and selectors to add all resources.
+    Add Labels and Selectors to all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`commonLabels`](/docs/tasks/labels_and_annotations/).
+See the [Tasks section] for examples of how to use `commonLabels`.
+
+### commonLabels
+Adds [Labels and Selectors] to resources.
+
+* **commonLabels** (map[string]string)
+
+    Map of labels to add to all resources. Labels will be added to resource selector and template fields where applicable.
+
+
+[Tasks section]: /docs/tasks/labels_and_annotations/
+[Labels and Selectors]: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

site/content/en/docs/Reference/API/Kustomization File/labels.md

@@ -6,5 +6,35 @@ weight: 10
 description: >
     Add labels and optionally selectors to all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`labels`](/docs/tasks/labels_and_annotations/).
+See the [Tasks section] for examples of how to use `labels`.
+
+### labels
+Adds labels and optionally selectors to all resources.
+
+* **labels** ([]Label)
+
+    List of labels and label selector options.
+
+    _Label holds labels to add to resources and options for customizing how those labels are applied, potentially using selectors and template metadata._
+
+    * **pairs** (map[string]string)
+
+        Map of labels that the transformer will add to resources.
+
+    * **includeSelectors** (bool), optional
+
+        IncludeSelectors indicates whether the transformer should include the fieldSpecs for selectors. Custom fieldSpec specified by `fields` will be merged with builtin fieldSpecs if this is true. Defaults to false.
+
+    * **includeTemplates** (bool), optional
+
+        IncludeTemplates indicates whether the transformer should include the `spec/template/metadata` fieldSpec. Custom fieldSpecs specified by `fields` will be merged with the `spec/template/metadata` fieldSpec if this is true. If IncludeSelectors is true, IncludeTemplates is not needed. Defaults to false.
+
+    * **fields** (\[\][FieldSpec]({{< relref "../Common%20Definitions/FieldSpec.md" >}})), optional
+
+        Fields specifies the field on each resource that LabelTransformer should add the label to. It essentially allows the user to re-define the field path of the Kubernetes labels field from `metadata/labels` for different resources.
+
+
+[Tasks section]: /docs/tasks/labels_and_annotations/
+[Labels and Selectors]: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

site/content/en/docs/Reference/API/Kustomization File/namePrefix.md

@@ -4,7 +4,18 @@ linkTitle: "namePrefix"
 type: docs
 weight: 11
 description: >
-    Prepends the value to the names of all resources and references.
+    Add prefixes to the names of all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`namePrefix`](/docs/tasks/namespaces_and_names/).
+See the [Tasks section] for examples of how to use `namePrefix`.
+
+### namePrefix
+Add prefixes to the names of all resources.
+
+* **namePrefix** (string)
+
+    NamePrefix will add a prefix to the names of all resources mentioned in the Kustomization file including generated resources such as ConfigMaps and Secrets.
+
+
+[Tasks section]: /docs/tasks/namespaces_and_names/

site/content/en/docs/Reference/API/Kustomization File/nameSuffix.md

@@ -4,7 +4,18 @@ linkTitle: "nameSuffix"
 type: docs
 weight: 13
 description: >
-    Appends the value to the names of all resources and references.
+    Add suffixes to the names of all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`nameSuffix`](/docs/tasks/namespaces_and_names/).
+See the [Tasks section] for examples of how to use `nameSuffix`.
+
+### nameSuffix
+Add suffixes to the names of all resources.
+
+* **nameSuffix** (string)
+
+    NameSuffix will add a suffix to the names of all resources mentioned in the Kustomization file including generated resources such as ConfigMaps and Secrets.
+
+
+[Tasks section]: /docs/tasks/namespaces_and_names/

site/content/en/docs/Reference/API/Kustomization File/namespace.md

@@ -6,5 +6,16 @@ weight: 12
 description: >
     Adds namespace to all resources.
 ---
+`apiVersion: kustomize.config.k8s.io/v1beta1`
 
-The Tasks section contains examples of how to use [`namespace`](/docs/tasks/namespaces_and_names/).
+See the [Tasks section] for examples of how to use `namespace`.
+
+### namespace
+Adds namespace to all resources.
+
+* **namespace** (string)
+
+    Namespace to add to all resources. This will override Namespace values that already exist.
+
+
+[Tasks section]: /docs/tasks/namespaces_and_names/

site/content/en/docs/Reference/API/Transformers/LabelTransformer.md

@@ -0,0 +1,29 @@
+---
+title: "LabelTransformer"
+linkTitle: "LabelTransformer"
+weight: 2
+date: 2024-02-12
+description: >
+  LabelTransformer adds labels to user-input resources.
+---
+
+See [Transformers]({{< relref "../Transformers" >}}) for common required fields.
+
+* **apiVersion**: builtin
+* **kind**: LabelTransformer
+* **metadata** ([ObjectMeta](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/object-meta/#ObjectMeta))
+
+  Standard object's metadata.
+
+* **labels** (map[string]string)
+
+  Map of labels that LabelTransformer will add to resources.
+
+  If not specified, LabelTransformer leaves the resources unchanged.
+
+* **fieldSpecs** (\[\][FieldSpec]({{< relref "../Common%20Definitions/FieldSpec.md" >}}))
+
+  fieldSpecs specifies the field on each resource that LabelTransformer should add the labels to.
+  It essentially allows the user to re-define the field path of the Kubernetes labels field from `metadata/labels` for different resources.
+
+  If not specified, LabelTransformer applies the labels to the `metadata/labels` field of all resources.

site/content/en/docs/Reference/API/Transformers/NamespaceTransformer.md

@@ -0,0 +1,36 @@
+---
+title: "NamespaceTransformer"
+linkTitle: "NamespaceTransformer"
+weight: 3
+date: 2024-02-12
+description: >
+  NamespaceTransformer sets the Namespace of user-input namespaced resources.
+---
+
+See [Transformers]({{< relref "../Transformers" >}}) for common required fields.
+
+* **apiVersion**: builtin
+* **kind**: NamespaceTransformer
+* **metadata** ([ObjectMeta](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/object-meta/#ObjectMeta))
+
+  Standard object's metadata.
+
+* **fieldSpecs** (\[\][FieldSpec]({{< relref "../Common%20Definitions/FieldSpec.md" >}})), optional
+
+  fieldSpecs allows the user to re-define the field path of the Kubernetes Namespace field from `metadata/namespace` for different resources.
+
+  If not specified, NamespaceTransformer applies the namespace to the `metadata/namespace` field of all resources.
+
+* **unsetOnly** (bool), optional
+
+  UnsetOnly indicates whether the NamespaceTransformer will only set namespace fields that are currently unset. Defaults to false.
+
+* **setRoleBindingSubjects** (RoleBindingSubjectMode), optional
+
+  SetRoleBindingSubjects determines which subject fields in RoleBinding and ClusterRoleBinding objects will have their namespace fields set. Overrides field specs provided for these types.
+
+  _RoleBindingSubjectMode specifies which subjects will be set. It can be one of three possible values:_
+
+  - `defaultOnly` (default): namespace will be set only on subjects named "default".
+  - `allServiceAccounts`: Namespace will be set on all subjects with `kind: ServiceAccount`.
+  - `none`: All subjects will be skipped.

site/content/en/docs/Reference/API/Transformers/PrefixTransformer.md

@@ -0,0 +1,29 @@
+---
+title: "PrefixTransformer"
+linkTitle: "PrefixTransformer"
+weight: 4
+date: 2024-02-12
+description: >
+  PrefixTransformer adds prefixes to the names of user-input resources.
+---
+
+See [Transformers]({{< relref "../Transformers" >}}) for common required fields.
+
+* **apiVersion**: builtin
+* **kind**: PrefixTransformer
+* **metadata** ([ObjectMeta](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/object-meta/#ObjectMeta))
+
+  Standard object's metadata.
+
+* **prefix** (string)
+
+  Prefix is the value that PrefixTransformer will prepend to the names of resources.
+
+  If not specified, PrefixTransformer leaves the names of resources unchanged.
+
+* **fieldSpecs** (\[\][FieldSpec]({{< relref "../Common%20Definitions/FieldSpec.md" >}}))
+
+  fieldSpecs specifies the field on each resource that PrefixTransformer should add the prefix to.
+  It essentially allows the user to re-define the field path of the Kubernetes name field from `metadata/name` for different resources.
+
+  If not specified, PrefixTransformer applies the prefix to the `metadata/name` field of all resources.

site/content/en/docs/Reference/API/Transformers/SuffixTransformer.md

@@ -0,0 +1,29 @@
+---
+title: "SuffixTransformer"
+linkTitle: "SuffixTransformer"
+weight: 5
+date: 2024-02-12
+description: >
+  SuffixTransformer adds suffixes to the names of user-input resources.
+---
+
+See [Transformers]({{< relref "../Transformers" >}}) for common required fields.
+
+* **apiVersion**: builtin
+* **kind**: SuffixTransformer
+* **metadata** ([ObjectMeta](https://kubernetes.io/docs/reference/kubernetes-api/common-definitions/object-meta/#ObjectMeta))
+
+  Standard object's metadata.
+
+* **suffix** (string)
+
+  Suffix is the value that SuffixTransformer will postfix to the names of resources.
+
+  If not specified, SuffixTransformer leaves the names of resources unchanged.
+
+* **fieldSpecs** (\[\][FieldSpec]({{< relref "../Common%20Definitions/FieldSpec.md" >}}))
+
+  fieldSpecs specifies the field on each resource that SuffixTransformer should add the suffix to.
+  It essentially allows the user to re-define the field path of the Kubernetes name field from `metadata/name` for different resources.
+
+  If not specified, SuffixTransformer applies the suffix to the `metadata/name` field of all resources.