Change: Fix documentation regarding methods type promise outcomes

Ref: https://dev.cfengine.com/issues/6538
Merge pull request #909 from nickanderson/redmine/6538

Change: Fix documentation regarding methods type promise outcomes