Volume yaml 271

fixes #271 
`ports` is optional as well.  Please move this heading up above the docs for that.