Cleanup effort in prep for GA push: Trim trailing whitespace... no func change

some docco updates

Removes the promise if more documentation to come. These docs are probably sufficient as is.

fix validation errors

Add a note that these are under development.

Sync with the codes about the independence of load balancing scheduler algorithms. (r722948 - r722952)