Update documentation especially for coma
Comments and cosmetics