improve hints doc