diff --git a/README.md b/README.md
index 3d9d30f69999e66becbf9e0bff94e57f473208c9_UkVBRE1FLm1k..61f263b19a6b7964cafc2a6ff6aeca38a7cb1ee4_UkVBRE1FLm1k 100644
--- a/README.md
+++ b/README.md
@@ -262,7 +262,11 @@
 ## Output files
 
 `beaver` output files have the following format:
-
+- if the resource is namespaced :
+```
+<kind>.<apiVersion>.<metadata.namespace>.<metadata.name>.yaml
+```
+- if the resource is clusterwide :
 ```
 <kind>.<apiVersion>.<metadata.name>.yaml
 ```