docuemntation improvements