clean and clarify, add limitation and hash info