metomi/rose#266: update and tidy config format

This addresses #266 - add id and URL link behaviour to the tutorial. I've added a small bit to the configuration reference as well.

I've also taken the opportunity to make sure we don't have spaces around the equals in our configuration examples, particularly in the metadata.

@matthewrmshin, please review.