hints added to Documentation