Add fixes for KYAML reference

content/en/docs/reference/_index.md

@@ -115,3 +115,19 @@ An archive of the design docs for Kubernetes functionality. Good starting points
 [Kubernetes Architecture](https://git.k8s.io/design-proposals-archive/architecture/architecture.md) and
 [Kubernetes Design Overview](https://git.k8s.io/design-proposals-archive).
 
+## Encodings
+
+Tools such as {{< glossary_tooltip text="kubectl" term_id="kubectl" >}}
+can work with different formats / encodings. These include:
+
+* [CBOR](https://cbor.io/), used on the network but **not** available as a kubectl output format
+  * See [CBOR resource encoding](https://kubernetes.io/docs/reference/using-api/api-concepts/#cbor-encoding)
+* [JSON](https://www.json.org/), available as a `kubectl` output format and also used at the HTTP layer
+* [KYAML](/docs/reference/encodings/kyaml), a Kubernetes dialect of YAML
+  * KYAML is essentially an _output format_; any place where you can provide KYAML to Kubernetes, you can also provide any other valid YAML input
+* [YAML](https://yaml.org/), available as a `kubectl` output format and also used at the HTTP layer
+
+Kubernetes also has a custom [protobuf encoding](/docs/reference/using-api/api-concepts/#protobuf-encoding) that is only used within HTTP messages.
+
+The `kubectl` tool supports some other output formats, such as _custom columns_;
+see [output formats](/docs/reference/kubectl/#output-options) in the kubectl reference.

content/en/docs/reference/encodings/_index.md

@@ -6,6 +6,6 @@ no_list: true
 card:
   name: encodings
   title: Kubernetes encodings
-  weight: 20
+  weight: 125
 ---