Readme text on Github out of date

[charlesweir]

Some of the descriptions (e.g. of Insert Figure) in the readme need updating to match new functionality.