From a723a715e7358b418267f90c59f2d88d690f873c Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jacobtomlinson@users.noreply.github.com>
Date: Tue, 7 Nov 2023 10:28:11 +0100
Subject: [PATCH] Add example to show all valid resource name schemes (#204)

---
 docs/examples/listing_resources.md | 37 ++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/examples/listing_resources.md b/docs/examples/listing_resources.md
index 698fa231..8a79fed8 100644
--- a/docs/examples/listing_resources.md
+++ b/docs/examples/listing_resources.md
@@ -52,6 +52,43 @@ for pod in await kr8s.asyncio.get("pods", namespace=kr8s.ALL):
 
 `````
 
+## List Ingresses (all styles)
+
+List all Ingresses in the current namespace using all styles from shorthand to explicit group and version naming.
+
+`````{tab-set}
+
+````{tab-item} Sync
+```python
+import kr8s
+
+# All of these are equivalent
+ings = kr8s.get("ing")                           # Short name
+ings = kr8s.get("ingress")                       # Singular
+ings = kr8s.get("ingresses")                     # Plural
+ings = kr8s.get("Ingress")                       # Title
+ings = kr8s.get("ingress.networking.k8s.io")     # Full group name
+ings = kr8s.get("ingress.v1.networking.k8s.io")  # Full with explicit version
+ings = kr8s.get("ingress.networking.k8s.io/v1")  # Full with explicit version alt.
+```
+````
+
+````{tab-item} Async
+```python
+import kr8s.asyncio
+
+# All of these are equivalent
+ings = await kr8s.asyncio.get("ing")                           # Short name
+ings = await kr8s.asyncio.get("ingress")                       # Singular
+ings = await kr8s.asyncio.get("ingresses")                     # Plural
+ings = await kr8s.asyncio.get("Ingress")                       # Title
+ings = await kr8s.asyncio.get("ingress.networking.k8s.io")     # Full group name
+ings = await kr8s.asyncio.get("ingress.v1.networking.k8s.io")  # Full with explicit version
+ings = await kr8s.asyncio.get("ingress.networking.k8s.io/v1")  # Full with explicit version alt.
+```
+````
+
+`````
 ## List Ready Pods
 
 Get a list of Pod resources that have the `Ready=True` condition.