minor teak to the documentation
fixed a typo and added more documentation