standardise docs html formatting
fix wrong details on API calls