fix inconsistiencies in docs