diff --git a/doc/namespaces.txt b/doc/namespaces.txt
new file mode 100644
index 0000000..c3ed662
--- /dev/null
+++ b/doc/namespaces.txt
@@ -0,0 +1,47 @@
+matrix{
+	//all matrix functionality
+	sync{
+		//resources for syncing with the server
+	}
+	json{
+		//standard json structures for sending events
+		message{
+			//json for messages
+			infobody{
+				//info member of message
+				thumbnail{
+					//thumbnail details
+				}
+			}
+		}
+		auth{
+			//login/logout type json stuff
+			authbody{
+				//body of auth json
+			}
+			identifierbody{
+				//identifier object of auth json
+			}
+		}
+		stdstrings{
+			rooms{
+				//json room event member names
+			}
+			client{
+				//client event member names
+			}
+			session{
+				//session event member names
+			}
+			events{
+				//matrix standard event type strings eg 'm.text'
+			}
+		}
+	}
+	rest{
+		//rest management structures for urls
+	}
+}
+raii{
+	//all supporting raii structures/classes
+}