some packaging-related docs cleanups

also, add instructions to the top of docs.js