improved docs according to suggestions from softlayer
Merge pull request #958 from crate/h/docs

improved docs according to suggestions from softlayer