fix formatting and add links to documentation