Change: Fix documentation regarding methods type promise outcomes

Ref: https://dev.cfengine.com/issues/6538
Document that now() returns agent start time

See redmine 4710 for discussion.
Merge pull request #909 from nickanderson/redmine/6538

Change: Fix documentation regarding methods type promise outcomes