documentation

Pull request #979: two links to best-practices page added, v6.0

Merge in WEB/documentation from feature/TR-288-6.0-D to release/6.0

* commit 'eb133e2ec98ddda267fbfbfb4aa568c23934b728':
  notetip position revised
  links to best-practices added