Made some README changes for #1155; migrate those changes into the website docs. Ideally, use this as a chance to reduce duplication between TSDoc comments, README, and website.