made some changes to the tutorials and docs in response to a users comments
Merge pull request #1657 from hschilling/P56547930-fix-tutorials

made some changes to the tutorials and docs in response to a users comments