Fix typos and errors in documentation.

Besides typos, I also changed the InitializingScoreTrend explanation, which I believe to be explained incorrectly. I discussed this on the forum, but never got a reply, see https://groups.google.com/forum/#!topic/optaplanner-dev/diEMZW4jQ0E.