update readme file

add information about javascript organization and application running. 
add links to documentation.
fix several markup issues