more changes for better documentation