1 files changed, 16 insertions, 3 deletions
diff --git a/docs/type_system/namespace.md b/docs/type_system/namespace.md
index f6b8b1c..e5b0020 100644
--- a/docs/type_system/namespace.md
+++ b/docs/type_system/namespace.md
@@ -13,20 +13,33 @@ A file with code
 
 ### \`export
 
-##### Type must be Fn, Overload, Const or Shared to export
+#### Type must be Fn, Overload, Const or Shared to export
+
+#### Re-exporting
 
 ## Imports
 
 ### \`import
 
 ```text
-Namespace `import Value[String]
+namespace : `import Value[String]
 ```
 
+All imports are relative to the importer
+
 ### \`use
 
 ```text
-Namespace `use Value[String]
+namespace : `use Value[String]
+```
+
+## Namespace destructuring
+
+```text
+namespace : `use Value[String]
+namespace[scope_name.namespace_name]
+namespcae[name] // resolves to namespace[name.name]
+`use Value[String] [name]
 ```
 
 ## Main