Changed diagrams to use ball-socket notation and completed API specifications