updated documentation with escaping HTML