added docs

examples and docs reflect what is seen at https://plot.ly/api