update format and fix internal links
language and spacing tweaks