map editor docs

[tjhance]

We could really use some documentation on the map editor. It is completely unclear how it works.