diff --git a/README.md b/README.md
index da7136b7..0b3cf0bf 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,14 @@
NetBox Operator extends the Kubernetes API by allowing users to manage NetBox resources – such as IP addresses and prefixes – directly through Kubernetes. This integration brings Kubernetes-native features like reconciliation, ensuring that network configurations are maintained automatically, thereby improving both efficiency and reliability.
+## The Claim Model
+The NetBox Operator implements a "Claim Model" which is also used in the Kubernetes PersistentVolumeClaims (PVCs).
+In this case, instead of disk storage, NetBox Operator dynamically allocates network resources (Prefixes and IP Addresses) based on claims submitted via custom resources.
+
+### Purpose
+This model ensures a declarative management of IP addressing and subnet allocation, with full NetBox integration.
+The users will create claims (PrefixClaims & IPAddressClaims), and the NetBox Operator will resolve them into actual Prefixes and IPAddresses within a designated parent prefix.
+
# Getting Started
diff --git a/docs/netbox-operator-high-level-architecture.drawio.svg b/docs/netbox-operator-high-level-architecture.drawio.svg
index 55a08d29..62fcb76f 100644
--- a/docs/netbox-operator-high-level-architecture.drawio.svg
+++ b/docs/netbox-operator-high-level-architecture.drawio.svg
@@ -1,457 +1,4 @@
-
+
+
+
+
\ No newline at end of file
diff --git a/docs/operational-manual.md b/docs/operational-manual.md
new file mode 100644
index 00000000..b9162e5b
--- /dev/null
+++ b/docs/operational-manual.md
@@ -0,0 +1,50 @@
+# Operational Manual
+
+This document describes how to troubleshoot errors in the NetBox Operator.
+Known issues are collected on the [GitHub issues](https://github.com/netbox-community/netbox-operator/issues) page.
+
+## Troubleshooting
+
+### Check Logs
+Use the following command to get logs from the operator:
+
+```bash
+kubectl logs -n deployment/netbox-operator-controller-manager
+```
+
+### Check CR Status
+Inspect the CRs status:
+
+```bash
+kubectl describe -n
+```
+
+E.g.:
+```bash
+kubectl describe prefixclaim prefixclaim-sample -n
+kubectl describe ipaddressclaim ipaddressclaim-sample -n
+kubectl describe prefix prefix-sample -n
+kubectl describe ipaddress ipaddress-sample -n
+```
+This will show you the status of the operator and any errors it may have encountered.
+
+### Verify Operator Version
+
+```bash
+kubectl get deployment netbox-operator-controller-manager -n -o=jsonpath="{.spec.template.spec.containers[*].image}"
+```
+
+### Look at Related Pods
+If netbox-oeprator is not running correctly, inspect the related pods:
+
+```bash
+kubectl logs deployment/netbox-operator-controller-manager -n -c manager
+kubectl describe pod -n
+```
+
+### Check Events
+Events might give hints about what’s going wrong:
+
+```bash
+kubectl get events -n --sort-by='.lastTimestamp'
+```
\ No newline at end of file
diff --git a/docs/prefixclaim-sample-with-netbox-running-in-cluster.drawio.svg b/docs/prefixclaim-sample-with-netbox-running-in-cluster.drawio.svg
index 99cd828a..5118715c 100644
--- a/docs/prefixclaim-sample-with-netbox-running-in-cluster.drawio.svg
+++ b/docs/prefixclaim-sample-with-netbox-running-in-cluster.drawio.svg
@@ -1,4 +1,4 @@
-
\ No newline at end of file
+
\ No newline at end of file