Improve JS transformer documentation (#9795)

* Improve JS transformer documentation

* Update documentation with further comments

* Fix typo in added documentation comments

Co-authored-by: Niklas Mischkulnig <[email protected]>

---------

Co-authored-by: pyamada (Remote Dev Environment) <[email protected]>
Co-authored-by: Niklas Mischkulnig <[email protected]>