=doc fix misleading Recommended Practices

also rename recommended static method from mkProps to props for Java
Merge pull request #1842 from akka/wip-props-docs-name-∂π

fix misleading Recommended Practices
Merge remote-tracking branch: upstream/master