fix some syntax / formatting in the docs