* fixing typo in rest switch template example
* adding example with template to docs
* adding generic info about response JSON
* making requested changes
* changing file mode, removing response parsing information
* updating docs with generic info and link to specific topic
* fixing file permissions