remove channel join docs, cleanup

milestones.md

@@ -34,6 +34,7 @@ Generally, we need to create the following features over the single milestones:
 - (improvement) disable skillcasting in outposts (enable via command?)
 - (improvement) get logged in after account registration automatically
 - (improvement) maps should be their own entity + cleanup area/map mess: Map (the macros), Maps (the defs), Instance
+- (improvement) `*socket crash*` is not a valid reply :P - also clean up the inconsistently named events etc.
 - (old feature) simple map layouts (loaded into mem from a trapezoid map file)
 - (old feature) whisper messages
 - (old feature) map based sanity check when entities update their position

topic_entity.md

@@ -34,25 +34,13 @@ which is the movement topic.
 
 ---
 
-Synchroneously join.
+Asynchroneous initial message after successful join
 
 ```
-join
-```
-
-Success:
-
-```
-join:ok
+initial
 - attributes      // attributes of the entity, see above
 ```
 
-Failure:
-
-```
-*socket crash*
-```
-
 ---
 
 Synchroneously change the map.

topic_group.md

@@ -12,26 +12,6 @@ figure this out and negotiate on its own using the existing APIs)_
 
 ---
 
-Synchroneously join.
-
-```
-join
-```
-
-Success:
-
-```
-join:ok
-```
-
-Failure:
-
-```
-*socket crash*
-```
-
----
-
 Asynchroneous client requests.
 
 ```

topic_movement.md

@@ -9,38 +9,18 @@ when the server propagates it back to you._
 
 ---
 
-Synchroneously join.
-
-```
-join
-```
-
-Success:
-
-```
-join:ok
-```
-
-Failure:
-
-```
-*socket crash*
-```
-
----
-
 Asynchroneous client requests.
 
 ```
 update
 - position        // the new position
-  - x
-  - y
-  - plane
+ - x
+ - y
+ - plane
 - goal            // the point towards we are moving
-  - x
-  - y
-  - plane
+ - x
+ - y
+ - plane
 - move_type       // movement type  (0-10)
 - velocity        // the new velocity coefficient (-1-2)
 ```
@@ -53,13 +33,13 @@ Asynchroneous server updates.
 update
 - entity          // event sender
 - position        // the new position
-  - x
-  - y
-  - plane
+ - x
+ - y
+ - plane
 - goal            // the point towards we are moving
-  - x
-  - y
-  - plane
+ - x
+ - y
+ - plane
 - move_type       // movement type  (0-10)
 - velocity        // the new velocity coefficient (-1-2)
 ```

topic_skill.md

@@ -7,26 +7,14 @@ empty skillbar slots._
 
 ---
 
-Synchroneously add the skill ability to your player.
+Asynchroneous initial message after successful join
 
 ```
-join
-```
-
-Success:
-
-```
-join:ok
+initial
 - unlocked_skills // overall available skills
 - skillbar        // your current skillbar as list of skill-ids
 ```
 
-Failure:
-
-```
-*socket crash*
-```
-
 ---
 
 Synchroneous client requests.

topic_social.md

@@ -17,26 +17,6 @@ server wont check them._
 
 ---
 
-Synchroneously join.
-
-```
-join
-```
-
-Success:
-
-```
-join:ok
-```
-
-Failure: (If no crash: Means that you're not allowed to join this topic)
-
-```
-join:error
-```
-
----
-
 Asynchroneous chat message event. (Topic-wide broadcast)
 Note that you will receive the Server -> Client broadcast yourself as well,
 after successfully sending a chat message.