Added substantial documentation concerning pyscript (#1187)

* Added substantial documentation concerning pyscript

* Made suggested changes

* final changes

* fixed grammatical errors

Co-authored-by: jay <you@example.com>
Co-authored-by: Todd Leonhardt <todd.leonhardt@gmail.com>
Co-authored-by: J A <jand@blah.blah>

Author: 4 people