Volume yaml 271

fixes #271 
docs should use semantic linefeeds - http://rhodesmill.org/brandon/2012/one-sentence-per-line/