updating the README to include all the latest API details

This needed some updating with the redesign and some 3rd-party
engines being developed.