add explanation and list link to view live docs
regen docs for #15