README improvements and better geard example