some modifications to documentation