adding documentation and explanations
adding example script