=act #3565 Move CAVEAT note to right apply method
Merge pull request #1698 from akka/wip-3565-props-apply-doc-patriknw

=act #3565 Move CAVEAT note to right apply method