Adds docs on For / yield

[jhalterman]

[danieldietrich]

@netzwerg came up with a great example for For-comprehensions. I will add it to the docs. You can get a sneak-peak here: https://gitter.im/javaslang/javaslang?at=573c07ccae26c1967f9f7c63 (please scroll down a bit)