updating documentation with hotlinks