big reshuffle:

* try to make 00_basis slightly more accessible and less terse
 * move CS API before Events, as it's meaningless to dive into specific events if you haven't been introduced to how the CS API works
 * Try to improve the beginning of the CS API by merging back in some of kegan's original v1 content (which has subsequently been deleted somewhere along the line?)
 * document m.presence event consistently
 * move typing from drafts to spec
 * move push stuff from drafts to spec
...and lots of other stuff

move push & typing from drafts into main spec.

scripts/gendoc.py

@@ -101,7 +101,8 @@ def prepare_env():
         pass
     
 def cleanup_env():
-    shutil.rmtree("./tmp")
+    pass
+    #shutil.rmtree("./tmp")
 
 def main():
     prepare_env()