Added shadows to the diagram.
Minor re-phrasing to api docs.