[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
OK, I'll take care of it, but please already remove the default values in the comments before merging this. :)