added documentation, and a minor change to make the oembed type optional