add comments
refactor server side
fix markdown