From 0fff403a7b2ece87fddc7dc3a79bec37bcbfeb81 Mon Sep 17 00:00:00 2001
From: Ashley Dumaine <5779804+AshleyDumaine@users.noreply.github.com>
Date: Thu, 22 Aug 2024 14:33:29 -0400
Subject: [PATCH] Update for firewallRef

---
 docs/src/topics/firewalling.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/docs/src/topics/firewalling.md b/docs/src/topics/firewalling.md
index f7f912ae2..ebf1d7a62 100644
--- a/docs/src/topics/firewalling.md
+++ b/docs/src/topics/firewalling.md
@@ -83,9 +83,15 @@ spec:
 ## Cloud Firewalls
 
 For controlling firewalls via Linode resources, a [Cloud Firewall](https://www.linode.com/products/cloud-firewall/) can
-be defined and provisioned via `LinodeFirewall` resources in CAPL. The created Cloud Firewall's ID can then be used in
-a `LinodeMachine` or a `LinodeMachineTemplate`'s `firewallID` field. Note that the `firewallID` field is currently
-immutable, so it must be set at creation time).
+be defined and provisioned via the `LinodeFirewall` resource in CAPL.
+
+The created Cloud Firewall can be used on a `LinodeMachine` or a `LinodeMachineTemplate` by setting the `firewallRef` field.
+Alternatively, the provisioned Cloud Firewall's ID can be used in the `firewallID` field.
+
+```admonish note
+The `firewallRef` and `firewallID` fields are currently immutable for `LinodeMachines` and `LinodeMachineTemplates`. This will
+be addressed in a later release. 
+```
 
 Example `LinodeFirewall`:
 ```yaml