updating with information from pull request against cf docs