[FLINK-1157] Document TaskManager slots and minor fixes.

- Move some background on the most important configuration values into the configuration guide
- Remove the term "UDF" because it is often being confused with UDFs in SQL
- Fixe some typos
see comment for JM config