Readme: Tell about ///links and ---notes

And general tidying up.