commit to make vital updates to current docs. This is the first time I've made changes to this portion of code so hopefully all goes well.