improved docs according to suggestions from softlayer