added examples to documentation and README