I'm don't think pointing users to a website we have no control over or a PDF/HTML file in the repo is a great practice. GitHub wiki seems like a possible alternative.