=doc fix misleading Recommended Practices

also rename recommended static method from mkProps to props for Java