reshuffling markdown and add some template docs