better permalinks
adding some more docs
added mode docs (most of them placeholders)